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1. Introduction 


This document contains the External Data Representation (XDR) 
[RFC4506] description of the NFSv4.2 protocol [RFC7862]. 


1.1. Requirements Language 


The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", 
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this 
document are to be interpreted as described in RFC 2119 [RFC2119]. 


2. XDR Description of NFSv4.2 


In order to facilitate implementations that support all of NFSv4.0, 
NFSv4.1, and NFSv4.2, the description includes operations and other 
features of NFSv4.0 and NFSv4.1 that do not apply to NFSv4.2. This 
XDR specification is fully compatible with the specification for 
NFSv4.0 [RFC7531], with the exception of the clientaddr4 structure, 
which has been replaced by (strictly, aliased to) netaddr4, which has 
the same members with the same purposes but the names have changed: 


(r netid -> na r netid, r addr -> na r addr) 


This effectively fully reconverges the NFSv4.0 [RFC7531] and NFSv4.1 
[RFC5662] strands of the XDR. 


The XDR description is provided in this document in a way that makes 
it simple for the reader to extract it into a form that is ready to 
compile. The reader can feed this document in the following shell 
Script to produce the machine-readable XDR description of NFSv4.2: 


«CODE BEGINS» 


#!/bin/sh 
grep "^ *///" | sed 824 */// SRE | aed soe ELLIS 


<CODE ENDS> 
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That is, if the above script is stored in a file called "extract.sh" 
and this document is in a file called "spec.txt", then the reader 
can do: 
«CODE BEGINS» 

sh extract.sh « spec.txt » nfs4 prot.x 


«CODE ENDS» 


The effect of the script is to remove leading white space from each 
line, plus a sentinel sequence of "///". 


The XDR description, with the sentinel sequence, follows: 


«CODE BEGINS» 


/// /* 

/// * This file was machine generated for [RFC7862]. 

/// * 

/// * Last updated Sun Mar 13 10:58:40 PDT 2016 

LLL SSL 

/// 

HT LE 

/// * Copyright (c) 2016 IETF Trust and the persons identified 
/// * as the authors. All rights reserved. 

/// * 

/// * Redistribution and use in source and binary forms, with 
/// * or without modification, are permitted provided that the 
/// * following conditions are met: 

Y a: 

/// * - Redistributions of source code must retain the above 
/// * copyright notice, this list of conditions and the 
A following disclaimer. 

FD & 

/// * - Redistributions in binary form must reproduce the above 
/// - copyright notice, this list of conditions and the 

/// * following disclaimer in the documentation and/or other 
[IK x materials provided with the distribution. 

SEL Ou 

/// * - Neither the name of Internet Society, IETF or IETF 

/// * Trust, nor the names of specific contributors, may be 
HF A used to endorse or promote products derived from this 
Ju xk software without specific prior written permission. 
FLOW 
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/// * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS 
/// * AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED 
FE E WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 

/// * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 
/// * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 

/// * EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 
/// * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 
/// * EXEMPLARY, OR CONSEOUENTIAL DAMAGES (INCLUDING, BUT 
Sif È NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 
P CE SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
/// * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
/// * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 
LEIS OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING 
/// * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
/// * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 

/// 

///  */ 

/// 

Wl Ml 

/// * This code was derived from RFC 7863. 

111. */ 

/// 

/// /* 

EEE. >& nfsv42.x 

BEL EL 

/// 


/// S#ifndef _AUTH SYS DEFINE FOR NFSv42 

/// %#define _AUTH SYS DEFINE. FOR NFSv42 

/// S#include «rpc/auth sys.h» 

/// štypedef struct authsys parms authsys parms; 
/// S#endif /* _AUTH SYS DEFINE FOR NFSv42 */ 
111 
/// /* 
/// * Basic typedefs for RFC 1832 data type definitions 
LILE  */ 


/// 

LED AS 

/// * typedef int int32 t; 

/// * typedef unsigned int uint32 t; 
/// * typedef hyper int64 t; 

/// * typedef unsigned hyper uint64 t; 
ILS EL 

/// 
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AASA 

/// * Sizes 

JAHE RT 

/// const NFS4_FHSIZE = 128; 

/// const NFS4_VERIFIER_SIZE = 8; 

/// const NFS4_OTHER_SIZE = 12; 

/// const NFS4_OPAQUE_LIMIT = 1024; 

/// const NFS4_SESSIONID_SIZE = 16; 

/// 

/// const NFSA INT64 MAX = OxT7fffffffffffffff; 
/// const NFSA UINT64 MAX = Oxffffffffffffffff; 
/// const NFSA INT32 MAX = Ox7fffffff; 

/// const NFSA UINT32 MAX = Oxffffffff; 

/// 

/// const NFS4_MAXFILELEN = Oxffffffffffffffff; 
/// const NFS4_MAXFILEOFF = Oxfffffffffffffffe; 
111 

111 

LA 

/// * File types 

111. */ 

/// enum nfs_ftype4 { 

/// NF 4REG = 1, /* Regular File */ 

/// NF4DIR = 2, /* Directory */ 

/// NF 4BLK = 3, /* Special File -- block device */ 
/// NF4CHR = 4, /* Special File -- character device */ 
/// NF 4LNK = 5, /* Symbolic Link */ 

/// NF 4SOCK = 6, /* Special File -- socket */ 
/// NF4FIFO = 7, /* Special File -- fifo */ 
/// NF4ATTRDIR = 8, /* Attribute Directory */ 
/// NF4NAMEDATTR = 9 /* Named Attribute */ 

/// Yi 

/// 

PT A 

/// * Error status 

[EL #7 


/// enum nfsstat4 { 


/// NFSA OK 250,5 /* everything is okay */ 
/// NFS4ERR PERM = 1, /* caller not privileged */ 
/// NFS4ERR NOENT = 2, /* no such file/directory */ 
/// NFS4ERR IO = 5, /* hard I/O error #4 
/// NFS4ERR NXIO = 6, /* no such device #7 
/// NFS4ERR ACCESS = 13, /* access denied x 
/// NFS4ERR EXIST = 17, /* file already exists */ 
/// NFS4ERR. XDEV - 18, /* different file systems */ 


/// 
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it was used in NFSv3, 


and we do not want a value in NFSv3 to have a different 


* 

* Please do not allocate value 19; 
* 

* meaning in NFSv4.x. 

x 

NFSAERR NOTDIR = 2:05 /* 
NFS4ERR_ISDIR S21, /* 
NFS4ERR_INVAL = 22, /* 
NFS4ERR_FBIG = 27, /* 
NFS4ERR_NOSPC = 28, /* 
NFS4ERR_ROFS = 30, (A 
NFS4ERR_MLINK = 31; /* 
NFS4ERR_NAMETOOLONG = 63, /* 
NFS4ERR_NOTEMPTY = 66, /* 
NFS4ERR_DQUOT = 69, JE 
NFS4ERR_STALE = 70, ee 
NFS4ERR_BADHANDLE = 10001, /* 
NFS4ERR BAD COOKIE = 10003, /* 
NFS4ERR NOTSUPP = 10004, /* 
NFS4ERR TOOSMALL = 10005, /* 
NFS4ERR SERVERFAULT = 10006, /* 
NFS4ERR BADTYPE = 10007, /* 
NFS4ERR DELAY = 10008, /* 
NFS4ERR SAME = 10009, /* 
NFS4ERR DENIED = 10010, /* 
NFS4ERR EXPIRED = 10011, /* 
NFSA4ERR LOCKED = 10012, /* 
NFS4ERR GRACE = 10013, /* 
NFS4ERR_FHEXPIRED = 10014, /* 
NFS4ERR SHARE DENIED = 10015, /* 
NFS4ERR WRONGSEC = 10016, /* 
NFS4ERR CLID INUSE = 10017, /* 
/* NFS4ERR RESOURCE is not a valid 
NFS4ERR RESOURCE = 10018, /* 
NFSA4ERR MOVED = 10019, /* 
NFS4ERR NOFILEHANDLE = 10020, /* 
NFS4ERR MINOR VERS MISMATCH= 10021 
NFS4ERR STALE CLIENTID = 10022, /* 
NFS4ERR STALE STATEID = 10023, /* 
NFS4ERR OLD STATEID = 10024, /* 
NFS4ERR BAD STATEID = 10025, /* 
NFS4ERR BAD SEQID = 10026, /* 
NFS4ERR NOT. SAME = 10027, /* 
NFS4ERR LOCK. RANGE = 10028, /* 
NFS4ERR_SYMLINK = 10029, /* 


r 
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2016 


should be a directory */ 
should not be a directory */ 
invalid argument */ 
file exceeds server max */ 
no space on file system */ 
read-only file system * / 
too many hard links Sa 
name exceeds server max */ 
directory not empty */ 
hard quota limit reached */ 
file no longer exists if 
illegal filehandle */ 
READDIR cookie is stale EL 
operation not supported + 
response limit exceeded if 
undefined server error */ 
type invalid for CREATE */ 
file "busy" -- retry Fre 
nverify says attrs same */ 
lock unavailable E 
lock lease expired */ 
I/O failed due to lock See 
in grace period */ 
filehandle expired */ 
share reserve denied lié 
wrong security flavor E 
client ID in use */ 

error in NFSv4.1. */ 
resource exhaustion * / 
file system relocated #7 
current FH is not set Pl 
/* minor vers not supp */ 
server has rebooted *4 
server has rebooted * 
state is out of sync e 
incorrect stateid */ 
request is out of seq. */ 
verify -- attrs not same */ 
overlapping lock range */ 
should be file/directory  */ 
[Page 6] 
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/// NFS4ERR RESTOREFH = 10030, /* no saved filehandle #7 
///  NES4ERR_LEASE MOVED = 10031, /* some file system moved */ 
/// NFS4ERR ATTRNOTSUPP = 10032, /* recommended attr not supp */ 
/// NFS4ERR NO GRACE = 10033, /* reclaim outside of grace */ 
/// NFS4ERR RECLAIM BAD = 10034, /* reclaim error at server */ 
/// NFS4ERR RECLAIM CONFLICT- 10035, /* conflict on reclaim */ 
/// NFS4ERR BADXDR = 10036, /* XDR decode failed */ 
/// NFS4ERR LOCKS HELD = 10037, /* file locks held at CLOSE */ 
/// NES4ERR_OPENMODE = 10038, /* conflict in OPEN and I/O */ 
/// NFS4ERR BADOWNER = 10039, /* owner translation bad x7 
/// NFS4ERR. BADCHAR = 10040, /* UTF-8 char not supported  */ 
/// NFS4ERR BADNAME = 10041, /* name not supported */ 
/// NFS4ERR BAD RANGE = 10042, /* lock range not supported  */ 
/// NFS4ERR LOCK NOTSUPP = 10043, /* no atomic up/downgrade */ 
/// NFS4ERR OP ILLEGAL = 10044, /* undefined operation */ 
/// NFS4ERR DEADLOCK = 10045, /* file-locking deadlock */ 
/// NFS4ERR FILE OPEN = 10046, /* open file blocks op 4 
/// NFS4ERR ADMIN REVOKED = 10047, /* lock-owner state revoked  */ 
/// NFSA4ERR CB PATH DOWN = 10048, /* callback path down */ 
111 

/// /* NESv4.1 errors start here. */ 

111 

/// NFS4ERR BADIOMODE = 10049, 

/// NFS4ERR BADLAYOUT = 10050, 

/// NFS4ERR BAD SESSION DIGEST = 10051, 

/// NFS4ERR BADSESSION = 10052, 

/// NFS4ERR BADSLOT = 10053, 


/// NFS4ERR COMPLETE ALREADY = 10054, 

/// NFS4ERR CONN NOT BOUND TO SESSION = 10055, 

/// NFS4ERR DELEG ALREADY WANTED = 10056, 

/// NFS4ERR BACK CHAN BUSY = 10057, /* backchan reqs outstanding */ 
/// NFS4ERR LAYOUTTRYLATER = 10058, 

/// NFS4ERR LAYOUTUNAVAILABLE = 10059, 

/// NFS4ERR NOMATCHING LAYOUT = 10060, 

/// NFS4ERR RECALLCONFLICT = 10061, 

/// NFS4ERR UNKNOWN LAYOUTTYPE = 10062, 

/// NFS4ERR SEO MISORDERED = 10063, /* unexpected seq. ID in req */ 
/// NFS4ERR. SEQUENCE POS 10064, /* [CB ]SEQ. op not 1st op */ 
/// NFS4ERR REQ TOO BIG 10065, /* reguest too big a 
/// NFS4ERR. REP. TOO BIG = 10066, /* reply too big */ 
/// NFS4ERR REP. TOO BIG TO CACHE =10067, /* rep. not all cached */ 
/// NFS4ERR RETRY UNCACHED REP -10068, /* retry + rep. uncached */ 
/// NFS4ERR UNSAFE COMPOUND -10069, /* retry/recovery too hard "uh 


/// NFS4ERR TOO MANY OPS = 10070, /* too many ops in [CB ]COMP */ 
/// NFS4ERR OP NOT IN SESSION -10071, /* op needs [CB ]SEQ. op */ 
/// NFS4ERR HASH ALG UNSUPP = 10072, /* hash alg. not supp */ 
111 /* Error 10073 is unused. */ 
/// NFS4ERR CLIENTID BUSY = 10074, /* client ID has state */ 
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/// NFS4ERR PNFS IO HOLE = 10075, /* IO to SPARSE file hole */ 
/// NFS4ERR SEO FALSE RETRY- 10076, /* retry != original reg */ 
/// NFS4ERR BAD HIGH SLOT = 10077, /* reg has bad highest slot  */ 
/// NFS4ERR DEADSESSION = 10078, /* new reg sent to dead sess */ 
/// NFS4ERR ENCR ALG UNSUPP= 10079, /* encr alg. not supp A 
/// NFS4ERR PNFS NO LAYOUT = 10080, /* I/O without a layout "i 
/// NFS4ERR NOT ONLY OP = 10081, /* addl ops not allowed */ 
/// NFS4ERR WRONG CRED = 10082, /* op done by wrong cred */ 
/// NFS4ERR WRONG TYPE = 10083, /* op on wrong type object */ 
/// NFS4ERR DIRDELEG UNAVAIL-10084, /* delegation not avail. */ 
/// NFS4ERR REJECT DELEG = 10085, /* cb rejected delegation */ 
/// NFS4ERR RETURNCONFLICT - 10086, /* layout get before return */ 
/// NFS4ERR DELEG REVOKED = 10087, /* deleg./layout revoked A 
LE 

/// /* NFSv4.2 errors start here. */ 

/// 

/// NFS4ERR PARTNER NOTSUPP= 10088, /* s2s not supported SA 
/// NFS4ERR PARTNER NO AUTH- 10089, /* s2s not authorized 27 
/// NFS4ERR UNION NOTSUPP = 10090, /* arm of union not supp Ui 
/// NFS4ERR OFFLOAD DENIED - 10091, /* dest not allowing copy Ty 
/// NFS4ERR. WRONG. LES = 10092, /* LES not supported Si 
/// NFS4ERR BADLABEL = 10093, /* incorrect label #7 
/// NFSAERR OFFLOAD NO REQS- 10094 /* dest not meeting reqs */ 
FEE 

/// 

FED a 

/// * Basic data types 

111. */ 

/// typedef opaque attrlist4<>; 

/// typedef uint32_t bitmap4<>; 

/// typedef uint64 t changeid4; 

/// typedef uint64 t clientid4; 

/// typedef uint32_t count4; 

/// typedef uint64 t length4; 

/// typedef uint32_t mode4; 

/// typedef uint64 t nfs_cookie4; 

/// typedef opaque nfs_fh4<NFS4_FHSIZE>; 

/// typedef uint64 t offset4; 

/// typedef uint32_t qop4; 

/// typedef opaque sec_oid4<>; 

/// typedef uint32_t sequenceid4; 

/// typedef uint32_t seqid4; 

/// typedef opaque sessionid4[NFS4_SESSIONID_SIZE]; 

/// typedef uint32_t slotid4; 

/// typedef opaque utf8string<>; 

/// typedef utf8string utf8str cis; 

/// typedef utf8string utf8str cs; 

/// typedef utf8string utf8str mixed; 
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/// typedef utf8str cs component4; 

/// typedef opaque linktext4<>; 

/// typedef utf8string ascii_REQUIRED4; 
/// typedef component4 pathname4<>; 


/// typedef opaque verifier4[NFS4 VERIFIER SIZE]; 
/// typedef string secret4<>; 


/// typedef uint32_t policy4; 
/// 

/// /* 

/// * Timeval 

/// */ 

/// struct nfstime4 ( 

/// int64_t seconds; 
/// uint32_t nseconds; 
/// Yi 

/// 

/// enum time how4 { 

111 SET. TO SERVER TIME4 = 0, 
111 SET TO CLIENT TIME4 = 1 
/// Yi 

111 


/// union settime4 switch (time how4 set it) { 
/// case SET TO CLIENT. TIME4: 


111 nfstime4 time; 
/// default: 

111 void; 

/// Yi 

/// 

/// 

/// typedef uint32 t nfs lease4; 
111 

/// /* 

/// * File attribute definitions 
/// */ 

111 

LIF? È 


/// * File System ID (FSID) structure for major/minor 
/// */ 
/// struct fsid4 { 


/// uint64_t major; 
/// uint64_t minor; 
AH Y; 

/// 
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BEL SPE 

/// * File system locations attribute 
/// * for relocation/migration and 
/// * related attributes 


ILS SL 

/// struct change_policy4 { 

/// uint64 t cp. major; 
/// uint64 t cp minor; 
/// Yi 

/// 

/// struct fs_location4 { 

/// utf8str_cis server<>; 
/// pathname4 rootpath; 
/// Yi 

/// 

/// struct £s locations4 { 

/// pathname4 fs. root; 
111 fs location4 locations<>; 
/// Yi 

/// 

/// /* 


/// * Various Access Control Entry (ACE) definitions 
///  */ 

/// 

LEE LE 

/// * Mask that indicates which ACEs are supported. 
/// * Values for the fattr4 aclsupport attribute. 


111. */ 

/// const ACL4 SUPPORT. ALLOW. ACL = 0x00000001; 

/// const ACL4 SUPPORT. DENY. ACL = 0x00000002; 

/// const ACL4 SUPPORT AUDIT ACL = 0x00000004; 

/// const ACL4 SUPPORT ALARM ACL = 0x00000008; 

/// 

/// 

/// typedef uint32_t acetype4; 

/// 

/// 

/// /* 

/// * acetype4 values. Others can be added as needed. 
///  */ 

/// const ACE4 ACCESS ALLOWED ACE TYPE = 0x00000000; 
/// const ACE4 ACCESS DENIED ACE, TYPE = 0x00000001; 
/// const ACE4 SYSTEM AUDIT ACE TYPE = 0x00000002; 
/// const ACE4 SYSTEM ALARM ACE TYPE = 0x00000003; 
111 

111 

111 
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/// /* 

/// * ACE flag 

/// */ 

/// typedef uint32_t aceflag4; 

/// 

/// 

/// /* 

/// * ACE flag values 

111. */ 

/// const ACE4 FILE INHERIT ACE = 0x00000001; 
/// const ACE4 DIRECTORY INHERIT ACE = 0x00000002; 
/// const ACE4 NO PROPAGATE. INHERIT. ACE = 0x00000004; 
/// const ACE4 INHERIT ONLY ACE = 0x00000008; 
/// const ACE4 SUCCESSFUL ACCESS ACE FLAG = 0x00000010; 
/// const ACE4 FAILED ACCESS ACE FLAG = 0x00000020; 
/// const ACE4 IDENTIFIER GROUP = 0x00000040; 
/// const ACE4 INHERITED ACE = 0x00000080; 
/// 

/// 

/// 

/// /* 

/// * ACE mask 

/// */ 

/// typedef uint32_t acemask4; 

JEL 

111 

/// /* 

/// * ACE mask values 

/// */ 

/// const ACE4_READ DATA = 0x00000001; 

/// const ACE4 LIST DIRECTORY = 0x00000001; 

/// const ACE4 WRITE. DATA = 0x00000002; 

/// const ACE4 ADD FILE = 0x00000002; 

/// const ACE4 APPEND DATA = 0x00000004; 

/// const ACE4 ADD SUBDIRECTORY = 0x00000004; 

/// const ACE4 READ NAMED. ATTRS = 0x00000008; 

/// const ACE4 WRITE NAMED ATTRS = 0x00000010; 

/// const ACE4_EXECUTE = 0x00000020; 

/// const ACE4 DELETE CHILD = 0x00000040; 

/// const ACE4 READ ATTRIBUTES = 0x00000080; 

/// const ACE4 WRITE ATTRIBUTES = 0x00000100; 

/// const ACE4 WRITE RETENTION = 0x00000200; 

/// const ACE4 WRITE RETENTION HOLD = 0x00000400; 

/// 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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ACE4_DELETE 
ACE4_READ_ACL 
ACE4 WRITE ACL 
ACE4 WRITE OWNER 
ACE4 SYNCHRONIZE 


const 
const 
const 
const 
const 


ACE4 GENERIC. READ -- defined 
ACE4 READ ACL | 
ACE4 READ DATA | 
ACE4 READ ATTRIBUTES | 
ACE4_SYNCHRONIZE 


+ + * * * * * 


/ 


const ACE4 GENERIC READ = 


/ 


ACE4 READ ACL | 

ACE4 WRITE DATA | 

ACE4 WRITE ATTRIBUTES | 
ACE4 WRITE ACL | 

ACE4 APPEND DATA | 
ACE4_SYNCHRONIZE 


+ + Xx Xo * * F * X 


/ 
const ACE4 GENERIC WRITE = 


ACE4 READ ACL | 

ACE4 READ ATTRIBUTES | 
ACE4 EXECUTE | 
ACE4_SYNCHRONIZE 


+ + + + * * * 


/ 
const ACE4 GENERIC_EXECUTE = 


XDR November 2016 


= 0x00010000; 
= 0x00020000; 
0x00040000; 
0x00080000; 
= 0x00100000; 


as a combination of 


0x00120081; 


ACE4 GENERIC WRITE -- defined as a combination of 


0x00160106; 


ACE4 GENERIC EXECUTE -- defined as a combination of 


0x001200A0; 


/* 
* ACE definition 
SA 
struct nfsace4 ( 
acetype4 type; 
aceflag4 flag; 
acemask4 access mask; 
utf8str mixed who; 
}; 
Standards 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
LEN 
/// 
/// 
/// 
/// 
/// 
/// 
/// 


Haynes 


/* 
* Access Control List (ACL) flag 
SA 


typedef uint32 t aclflag4; 


/* 
* ACL flag values 
x 
const ACL4 AUTO INHERIT = 0x00000001; 
const ACL4 PROTECTED = 0x00000002; 
const ACL4 DEFAULTED = 0x00000004; 
/* 
* Version 4.1 ACL definition 
*/ 
struct nfsacl41 { 
aclflag4 na41_flag; 
nfsace4 na41 aces<>; 
}; 
/* 


* Field definitions for the fattr4_mode 

* and fattr4_mode_set_masked attributes 

XJ 
const MODE4_SUID = 0x800; /* set user id on execution */ 
const MODE4_SGID = 0x400; /* set group id on execution */ 
const MODE4_SVTX = 0x200; /* save text even after use */ 
const MODE4_RUSR = 0x100; /* read permission: owner */ 
const MODE4_WUSR = 0x080; /* write permission: owner */ 
const MODE4_XUSR = 0x040; /* execute permission: owner */ 
const MODE4_RGRP = 0x020; /* read permission: group */ 
const MODE4_WGRP = 0x010; /* write permission: group */ 
const MODE4_XGRP = 0x008; /* execute permission: group */ 
const MODE4_ROTH = 0x004; /* read permission: other */ 
const MODE4_WOTH = 0x002; /* write permission: other */ 
const MODE4_XOTH = 0x001; /* execute permission: other */ 
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ALLE 

/// * Masked mode for the mode set masked attribute 
FEYÈ ET 

/// struct mode masked4 { 

/// mode4 mm value to set; /* Values of bits 


111 to set or reset 
111 in mode */ 

/// 

/// mode4 mm mask bits; /* Mask of bits to 
/// set or reset 
/// in mode */ 

/// Yi 

/// 

/// /* 


/// * Special data/attribute associated with 

/// * file types NF4BLK and NF4CHR 

LIL  */ 

/// struct specdata4 ( 

/// uint32_t specdatal; /* Major device number */ 
/// uint32_t specdata2; /* Minor device number */ 


/// Yi 

/// 

/// /* 

/// * Values for fattr4. fh expire type 

EE] EN 

/// const FH4_PERSISTENT = 0x00000000; 
/// const FH4 NOEXPIRE. WITH OPEN = 0x00000001; 
/// const FH4 VOLATILE. ANY = 0x00000002; 
/// const FH4 VOL MIGRATION = 0x00000004; 
/// const FH4 VOL RENAME = 0x00000008; 
111 

111 

/// struct netaddr4 { 

/// /* See struct rpcb in RFC 1833. */ 
/// string na_r netid<>; /* Network id */ 
/// string na_r addr<>; /* Universal address */ 
/// Yi 

/// 

/// 

(ELS 

/// * Data structures new to NFSv4.1 

JAH RT 

111 

/// struct nfs_impl_id4 ( 

/// utf8str_cis nii_domain; 

/// utf8str cs nii name; 

(11 nfstime4 nii_date; 

/// Yi 
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/// 

/// 

LEE Le 

/// * Stateid 

LiL EL 

/// struct stateid4 ( 

/// uint32_t seqid; 

/// opague other [NFS4. OTHER SIZE]; 
/// Yi 

/// 

/// enum layouttype4 { 

111 LAYOUT4 NFSV4. 1 FILES = Oxl, 
111 LAYOUT4. OSD2 OBJECTS = 0x2, 
/// LAYOUT4_BLOCK_VOLUME = 0x3 
EE: 

/// 

/// struct layout_content4 { 

/// layouttype4 loc type; 

ETI opaque loc body<>; 

TG 

/// 

/// 

/// %/* 

/// $ * LAYOUTA OSD2 OBJECTS loc body description 
/// $ * is in a separate .x file. 

/// & */ 

/// $ 

/// %/* 

/// $ * LAYOUT4 BLOCK VOLUME loc body description 
/// $ * is in a separate .x file. 

/// & */ 

/// 

/// struct layouthint4 { 

/// layouttype4 loh type; 
111 opague loh_body<>; 
Lk Y 

/// 

/// enum layoutiomode4 { 

/// LAYOUTIOMODE4_READ E 

111 LAYOUTIOMODE4. RW E 

/// LAYOUTIOMODE4_ANY = 3 

/// Yi 

/// 
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/// struct layout4 { 


/// offset4 lo offset; 

111 length4 lo length; 

111 layoutiomode4 lo. iomode; 

111 layout. content4 lo. content; 

/// Yi 

/// 

/// const NFS4 DEVICEID4 SIZE = 16; 

/// 

/// typedef opaque deviceid4[NFS4 DEVICEID4 SIZE]; 
/// 

/// struct device_addr4 { 

/// layouttype4 da layout. type; 
FFF opague da_addr_body<>; 
EE 

/// 

/// 

/// struct layoutupdate4 { 

/// layouttype4 lou type; 

111 opague lou body<>; 

AL Xi 

/// 

/// $ 

/// /* Constants used for LAYOUTRETURN and CB LAYOUTRECALL */ 
/// const LAYOUT4_RET REC FILE = 13 

/// const LAYOUT4_RET_REC_FSID = 2; 

/// const LAYOUT4_RET_REC_ALL 2:3; 

/// $ 

/// enum layoutreturn_type4 ( 

/// LAYOUTRETURN4_FILE = LAYOUT4_RET_REC_FILE, 
/// LAYOUTRETURN4_FSID = LAYOUT4_RET_REC_FSID, 
/// LAYOUTRETURN4_ALL = LAYOUT4_RET_REC_ALL 
/// Yi 

Ed} 

/// struct layoutreturn file4 { 

FFF offset4 lrf offset; 

/// length4 lrf length; 

111 stateid4 lrf_stateid; 

/// $ /* layouttype4 specific data */ 

/// opaque lrf_body<>; 

/// Yi 

/// 

/// union layoutreturn4 switch (layoutreturn type4 lr returntype) { 
/// case LAYOUTRETURN4_FILE: 

/// layoutreturn_file4 lr layout; 
111 default: 

111 void; 

TALE NG 
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/// $ 

111 

/// enum fs4 status type { 

111 STATUS4. FIXED 1; 

111 STATUS4. UPDATED = 2; 

111 STATUS4_VERSIONED = 3, 

/// STATUS4_WRITABLE = 4, 

/// STATUS4_REFERRAL = 5 

[Ll Y 

/// 

/// struct fs4 status ( 

111 bool fss_absent; 
/// fs4_status_type fss_type; 
FFF utf8str_cs fss_source; 
111 utf8str cs fss current; 
/// int32_t fss_age; 

111 nfstime4 fss. version; 
/// Yi 

HH 

111 


/// const TH4 READ SIZE = 
/// const TH4 WRITE. SIZE = 
/// const TH4 READ IOSIZE = 
/// const TH4_WRITE_IOSIZE 
FEL 

/// typedef length4 threshold4_read_size; 
/// typedef length4 threshold4_write_size; 
/// typedef length4 threshold4 read iosize; 
/// typedef length4 threshold4 write iosize; 


F 
, 


F 


QN I| © 


, 


11 

/// struct threshold item4 { 

/// layouttype4 thi layout type; 
111 bitmap4 thi hintset; 

111 opague thi hintlist<>; 
/// Yi 

/// 

/// struct mdsthreshold4 ( 

/// threshold_item4 mth_hints<>; 

/// Yi 

/// 

/// const RET4_DURATION_INFINITE = Oxffffffffffffffff; 
/// struct retention get4 { 

/// uint64_t rg_duration; 

/// nfstime4 rg_begin_time<l>; 
/// Yi 

/// 
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/// struct retention_set4 { 


/// bool rs enable; 

111 uint64 t rs duration<1>; 

/// Yi 

111 

/// const FSCHARSET CAP4 CONTAINS NON UTF8 = 0x1; 

/// const FSCHARSET CAP4 ALLOWS ONLY UTF8 = 0x2; 

111 

/// typedef uint32 t fs charset. cap4; 

111 

/// 

/// /* 

/// * Data structures new to NFSv4.2 

/// ZI 

/// 

/// enum netloc type4 { 

111 NL4. NAME =; 

111 NL4 URL = 2, 

111 NL4_NETADDR = 3 

/// Yi 

/// union netloc4 switch (netloc type4 nl type) ( 

111 case NL4 NAME: utf8str cis nl name; 

111 case NL4 URL: utf8str cis nl url; 

111 case NL4 NETADDR: netaddr4 nl_addr; 

/// Yi 

/// 

/// enum change_attr_type4 ( 

/// NFS4 CHANGE TYPE IS MONOTONIC INCR =. 0; 
111 NFS4 CHANGE TYPE IS VERSION. COUNTER =, 
/// NFS4_CHANGE_TYPE_IS_VERSION_COUNTER_NOPNFS = 2, 
/// NFS4_CHANGE_TYPE_IS_TIME_METADATA =) 3, 
/// NFS4_CHANGE_TYPE_IS_UNDEFINED = 4 
//L Yi 

111 

/// struct labelformat. spec4 { 

/// policy4 lfs_lfs; 

/// policy4 lfs_pi; 

/// Yi 

/// 

/// struct sec label4 ( 

111 labelformat. spec4 slai lfs; 

111 opague slai data<>; 

//L Yi 

/// 

/// 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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struct copy from auth priv ( 


secret4 
netloc4 


utf8str mixed 
}; 


cfap_shared_ secret; 
cfap_ destination; 
/* The NFSv4 user name that the user principal 


cfap_username; 


struct copy to auth priv { 
/* Equal to cfap shared secret */ 


secret4 
netloc4 


/* The NFSv4 user name that the user principal 


utf8str mixed 
}; 


ctap_shared_ secret; 


ctap_source<>; 


ctap username; 


struct copy. confirm auth priv ( 


/* Equal to GSS GetMIC () 


opague 


utf8str mixed 
}; 


ccap_username; 


struct app data block4 ( 


offset4 
length4 
length4 
length4 
count4 

length4 
opaque 


struct data4 ( 
offset4 
opague 
}; 


struct data_info4 { 
offset4 
length4 

}; 


adb_offset; 
adb_block_size; 
adb_block_count; 
adb_reloff_blocknum; 
adb_block_num; 

adb reloff pattern; 
adb pattern<>; 


d offset; 
d data<>; 


di offset; 
di length; 
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of cfap shared secret 
ccap shared secret mic<>; 
/* The NFSv4 user name that the user principal 


November 2016 


maps to */ 


maps to */ 


ef 


maps to */ 
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/// 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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/// 
/// 
/// 
/// 
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enum data_content4 { 


}; 
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NFS4 CONTENT DATA = 0, 
NFS4 CONTENT. HOLE = 1 


enum stable how4 ( 


}; 


struct write response4 { 


}; 


/* 


* NFSv4.1 attributes 


*/ 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 


UNSTABLE4 
DATA SYNC4 
FILE SYNC4 


stateid4 
length4 


stable. how4 


verifier4 


bitmap4 
nfs_ftype4 
uint32_t 
changeid4 
uint64 t 
bool 

bool 

bool 
fsid4 
bool 

nfs lease4 
nfsstat4 
nfsace4 
uint32_t 
bool 

bool 

bool 

bool 

bool 
uint64_t 
uint64_t 
nfs_fh4 
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wr callback id<1>; 
wr count; 

wr committed; 

wr writeverf; 


fattr4 supported attrs; 
fattr4 type; 
fattr4 fh expire type; 
fattr4 change; 

fattr4 size; 
fattr4 link support; 
fattr4 symlink support; 
fattr4 named attr; 
fattr4 fsid; 

fattr4 unique handles; 
fattr4 lease time; 
fattr4 rdattr error; 
fattr4 acl<>; 

fattr4 aclsupport; 
fattr4 archive; 

fattr4 cansettime; 
fattr4 case insensitive; 
fattr4 case preserving; 
fattr4 chown restricted; 
fattr4 fileid; 

fattr4 files avail; 
fattr4 filehandle; 
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/// typedef uint64 t fattr4 files free; 

/// typedef uint64 t fattr4 files total; 

/// typedef fs locations4 fattr4 fs locations; 
/// typedef bool fattr4 hidden; 

/// typedef bool fattr4 homogeneous; 

/// typedef uint64 t fattr4 maxfilesize; 

/// typedef uint32 t fattr4 maxlink; 

/// typedef uint32 t fattr4 maxname; 

/// typedef uint64 t fattr4 maxread; 

/// typedef uint64 t fattr4 maxwrite; 

/// typedef ascii REQUIREDA fattr4 mimetype; 

/// typedef mode4 fattr4_mode; 

/// typedef mode_masked4 fattr4_mode_set_masked; 
/// typedef uint64 t fattr4_mounted_on_fileid; 
/// typedef bool fattr4_no_trunc; 

/// typedef uint32_t fattr4_numlinks; 


/// typedef utf8str mixed fattr4_owner; 
/// typedef utf8str_mixed fattr4_owner_group; 


/// typedef uint64 t fattr4_quota_avail_hard; 
/// typedef uint64 t fattr4_quota_avail_soft; 
/// typedef uint64 t fattr4_quota_used; 

/// typedef specdata4 fattr4_rawdev; 

/// typedef uint64 t fattr4_space_avail; 

/// typedef length4 fattr4_space_free; 

/// typedef uint64 t fattr4_space_total; 

/// typedef uint64 t fattr4_space_used; 

/// typedef bool fattr4_system; 

/// typedef nfstime4 fattr4_time_access; 

/// typedef settime4 fattr4_time_access_set; 
/// typedef nfstime4 fattr4_time_backup; 

/// typedef nfstime4 fattr4_time_create; 

/// typedef nfstime4 fattr4_time_delta; 

/// typedef nfstime4 fattr4_time_metadata; 

/// typedef nfstime4 fattr4_time_modify; 

/// typedef settime4 fattr4_time_modify_set; 
PER JE 

/// * Attributes new to NFSv4.1 

LIS SÈL 

/// typedef bitmap4 fattr4_suppattr_exclcreat; 
/// typedef nfstime4 fattr4 dir notif delay; 
/// typedef nfstime4 fattr4 dirent notif delay; 
/// typedef layouttype4 fattr4 fs layout types<>; 
/// typedef fs4 status fattr4 fs status; 

/// typedef fs charset cap4 fattr4 fs charset cap; 
/// typedef uint32 t fattr4 layout alignment; 
/// typedef uint32 t fattr4 layout blksize; 
/// typedef layouthint4 fattr4 layout hint; 

/// typedef layouttype4 fattr4 layout types<>; 


Haynes Standards Track [Page 21] 


RFC 7863 


/// 
/// 
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/// 
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/// 
/// 
/// 
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/// 
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/// 
/// 
/// 
/// 
/// 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
typedef 
/* 


mdsthreshold4 
retention get4 
retention set4 
retention get4 
retention set4 
uint64 t 
nfsacl41 
nfsacl41 
change policy4 
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fattr4_mdsthreshold; 
fattr4_retention get; 
fattr4_retention set; 
fattr4 retentevt get; 
fattr4 retentevt set; 
fattr4 retention hold; 
fattr4 dacl; 

fattr4 sacl; 

fattr4 change policy; 


* Attributes new to NFSv4.2 


*/ 
typedef 


uint64_t 


fattr4 space freed; 


typedef change attr type4 
fattr4 change attr type; 


typedef 
typedef 


const FATTR4 SUPPORTED ATTRS = 


sec label4 
uint32 t 


* 
% * REOUIRED attributes 
* 


const FATTR4 TYPE 


const FATTR4 FH EXPIRE TYPE = 


const FATTR4 CHANGE 
const FATTR4 SIZE 


const FATTR4 LINK SUPPORT = 
const FATTR4 SYMLINK SUPPORT = 
const FATTR4 NAMED ATTR 


const FATTR4 FSID 


const FATTR4 UNIOUE HANDLES = 
const FATTR4 LEASE TIME 
const FATTR4 RDATTR ERROR = 
const FATTR4 FILEHANDLE = 


* 
$ * New 
* 


/ 


const FATTR4 SUPPATTR EXCLCREAT 


to NESv4.1 


const FATTR4 ACL 


const FATTR4 ACLSUPPORT 


const FATTR4 ARCHIVE 


const FATTR4 CANSETTIME 


fattr4 sec label; 
fattr4_clone_blksize; 


Ne Ne ne ono 


mm 


| Il 

PPP L © -1 oO O1 NP © 
OH ON NS se sen 

Ne Ne No 


Bo 


* 
$ * RECOMMENDED attributes 
* 


= 12; 
= 13; 
14; 
15; 


const FATTR4 CASE INSENSITIVE - 16; 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
LEN 
/// 
/// 
/// 
/// 
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FATTR4 CASE PRESERVING 
FATTR4 CHOWN RESTRICTED 
FATTR4 FILEID 

FATTR4 FILES AVAIL 
FATTR4 FILES FREE 
FATTR4 FILES TOTAL 
FATTR4 FS LOCATIONS 
FATTR4 HIDDEN 

FATTR4 HOMOGENEOUS 
FATTR4 MAXFILESIZE 
FATTR4 MAXLINK 

FATTR4 MAXNAME 

FATTR4 MAXREAD 

FATTR4 MAXWRITE 

FATTR4 MIMETYPE 

FATTR4 MODE 
FATTR4 NO TRUNC 

FATTR4 NUMLINKS 

FATTR4 OWNER 

FATTR4 OWNER GROUP 
FATTR4 QUOTA AVAIL HARD 
FATTR4 QUOTA AVAIL SOFT 
FATTR4 QUOTA USED 
FATTR4 RAWDEV 

FATTR4 SPACE AVAIL 
FATTR4 SPACE FREE 
FATTR4 SPACE TOTAL 
FATTR4 SPACE USED 
FATTR4 SYSTEM 
FATTR4 TIME ACCESS 
FATTR4 TIME ACCESS SET 
FATTR4 TIME BACKUP 
FATTR4 TIME CREATE 
FATTR4 TIME DELTA 
FATTR4 TIME METADATA 
FATTR4 TIME MODIFY 
FATTR4 TIME MODIFY SET 
FATTR4 MOUNTED ON FILEID 


* 
$ * New to NFSv4.1 
* 


FATTR4 DIR NOTIF DELAY 
FATTR4_DIRENT_NOTIF_DELAY 
FATTR4_DACL 

FATTR4_SACL 
FATTR4_CHANGE_POLICY 
FATTR4_FS_STATUS 


= 56; 


57; 
58; 
59; 
60; 
61; 
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/// const FATTRA FS LAYOUT TYPES = 62; 
/// const FATTRA LAYOUT HINT = 63; 
/// const FATTRA LAYOUT TYPES = 64; 
/// const FATTRA LAYOUT BLKSIZE = 65; 
/// const FATTRA LAYOUT ALIGNMENT = 66; 
/// const FATTRA FS LOCATIONS INFO = 67; 
/// const FATTRA MDSTHRESHOLD = 68; 
/// const FATTRA RETENTION GET = 69; 
/// const FATTRA RETENTION SET = 70; 
/// const FATTR4. RETENTEVT. GET zv 
/// const FATTRA RETENTEVT SET = 72; 
/// const FATTR4. RETENTION. HOLD = 13; 
/// const FATTR4. MODE. SET. MASKED = 74; 
/// const FATTRA FS CHARSET CAP = 76; 
111 
/// SIK 

/// $ * New to NFSv4.2 

/// $ * 

/// const FATTR4_CLONE_BLKSIZE = 77; 
/// const FATTR4_SPACE_FREED 78; 
/// const FATTR4. CHANGE ATTR TYPE 79; 
/// const FATTR4. SEC. LABEL = 80; 
111 

FFF AS 

/// * File attribute container 

FFF OV 

/// struct fattr4 ( 

111 bitmap4 attrmask; 

111 attrlist4 attr_vals; 
EE Yi 

111 

/// /* 

/// * Change info for the client 

TIE FL 

/// struct change_info4 { 

/// bool atomic; 

/// changeid4 before; 

/// changeid4 after; 

FEL SG 

/// 

/// typedef netaddr4 clientaddr4; 

/// 
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ALALE 

/// * Callback program info as provided by the client 
{KI E] 

/// struct cb client4 { 


/// uint32_t cb. program; 
111 netaddr4 cb location; 
/// Yi 

/// 

/// /* 

/// * NFSv4.0 long-hand client ID 

FF NV 

/// struct nfs client id4 { 

111 verifier4 verifier; 
FFF opague id«NFS4 OPAQUE LIMIT»; 
/// Yi 

111 

/// /* 


/// * NFSv4.1 client owner (aka long-hand client ID) 
/// */ 


/// struct client_owner4 ( 


111 verifier4 co verifier; 

/// opaque co_ownerid<NFS4_OPAQUE_LIMIT>; 
/// Yi 

111 

111 

SAL AE 

/// * NFSv4.1 server owner 

FI € 

/// struct server owner4 ( 

/// uint64_t so minor id; 

/// opaque so_major_id<NFS4_OPAQUE_LIMIT>; 
/// Yi 

/// 

/// 

/// struct state_owner4 ( 

FFF clientid4 clientid; 

111 opague owner<NFS4. OPAQUE LIMIT»; 
/// Yi 

111 


/// typedef state owner4 open owner4; 
/// typedef state owner4 lock. owner4; 
111 
111 
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/// enum nfs lock type4 { 


111 READ. LT E 

111 WRITE. LT =D, 

111 READW. LT = 3; /* Blocking read */ 
111 WRITEW LT 4 /* Blocking write */ 
/// Yi 

11 

11 

/// $ 


/// %/* Input for computing subkeys */ 
/// enum ssv_subkey4 { 


111 SSV4. SUBKEY MIC I2T 1, 
111 SSV4. SUBKEY MIC T2I E 
111 SSV4. SUBKEY SEAL I2T = vi; 
/// SSV4 SUBKEY SEAL T2I 4 
/// Yi 

/// $ 

111 

/// $ 


/// %/* Input for computing smt hmac */ 
/// struct ssv mic plain tkn4 ( 

111 uint32 t smpt ssv seq; 

/// opaque smpt_orig_plain<>; 
FEE 
/// $ 
/// 
/// $ 
/// $/ 
/// $ 
/// $ 
/// $ 
/// struct ssv mic tkn4 { 

111 uint32_t smt_ssv_seq; 
TIE opaque smt_hmac<>; 
/// ) 
/// $ 
/// 
/// $ 
/// $/* Input for computing ssct encr data and ssct hmac */ 
/// struct ssv seal plain tkn4 ( 


Secret State Verifier Generic Security Service (SSV GSS) 
PerMsgToken token 


111 opague sspt confounder<>; 
111 uint32 t sspt ssv seq; 

111 opague sspt orig plain<>; 
111 opague sspt pad<>; 

/// Yi 

/// $ 

/// 

/// $ 
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/// %/* SSV GSS SealedMessage token */ 
/// struct ssv_seal_cipher_tkn4 { 


/// uint32_t ssct_ssv_seq; 

EEL opaque ssct_iv<>; 

/// opague ssct. encr data<>; 

111 opague ssct_hmac<>; 

/// Yi 

/// $ 

/// 

LEE A 

/// * Defines an individual server replica 
111. */ 

/// struct fs_locations_server4 { 

/// int32_t fls_currency; 
/// opague fls_info<>; 
/// utf8str_cis fls_server; 
/// Yi 

/// 

LEE 


/// * Byte indices of items within 
/// * fls info: flag fields, class numbers, 
/// * bytes indicating ranks and orders 


///  */ 

/// const FSLI4BX_GFLAGS = 0; 
/// const FSLI4BX_TFLAGS = 1; 
/// 


/// const FSLI4BX_CLSIMUL =) 
/// const FSLIABX CLHANDLE = 3 
/// const FSLI4BX_CLFILEID = 4; 
/// const FSLI4BX CLWRITEVER =. 
/// const FSLI4BX CLCHANGE = 6 
/// const FSLIABX CLREADDIR zu 


111 

/// const FSLI4BX_READRANK = 8; 
/// const FSLI4BX_WRITERANK = 9; 
/// const FSLI4BX_READORDER = 10; 
/// const FSLI4BX_WRITEORDER = 11; 
/// 

LES AS 

/// * Bits defined within the general flag byte 
111. */ 

/// const FSLI4GF_WRITABLE = 0x01; 
/// const FSLI4GF_CUR_REQ = 0x02; 
/// const FSLI4GF_ABSENT = 0x04; 
/// const FSLI4GF_GOING = 0x08; 
/// const FSLI4GF_SPLIT = 0x10; 
/// 
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FL A 

/// * Bits defined within the transport flag byte 
LATE SET 

/// const FSLIATF RDMA = 0x01; 

11 

/// /* 

/// * Defines a set of replicas sharing 

/// * a common value of the root path 

/// * within the corresponding 

/// * single-server namespaces 


FF > A 

/// struct fs locations item4 { 

/// fs_locations_server4 fli_entries<>; 
/// pathname4 fli_rootpath; 
/// Yi 

/// 

/// /* 


/// * Defines the overall structure of 
/// * the fs locations info attribute 


111. */ 

/// struct fs locations info4 ( 

/// uint32_t fli_flags; 
/// int32 t fli valid for; 
111 pathname4 fli fs root; 
111 fs. locations. item4 fli items<>; 
/// Yi 

111 

ELE 

/// * Flag bits in fli flags 

IIL */ 

/// const FSLI4IF_VAR_SUB = 0x00000001; 
111 


/// typedef fs locations info4 fattr4 fs locations info; 
111 


/// const NFL4_UFLG MASK = 0x0000003F; 
/// const NFL4_UFLG DENSE = 0x00000001; 
/// const NFL4 UFLG COMMIT THRU MDS = 0x00000002; 
/// const NFL42_UFLG_IO_ADVISE_THRU_MDS = 0x00000004; 
/// const NFL4_UFLG_STRIPE_UNIT_SIZE_MASK = OxFFFFFFCO; 
/// 

/// typedef uint32 t nfl util4; 

111 

/// & 

/// 
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/// enum filelayout hint. care4 { 

111 NFLH4 CARE DENSE = NFL4 UFLG DENSE, 
111 
FL NFLH4 CARE COMMIT THRU MDS 

111 = NFL4 UFLG COMMIT THRU MDS, 
111 
111 NFL42 CARE IO ADVISE THRU MDS 

111 = NFL42 UFLG IO ADVISE THRU MDS, 
111 
111 NFLH4 CARE STRIPE UNIT SIZE 

111 = 0x00000040, 
111 
111 NFLH4 CARE STRIPE COUNT = 0x00000080 
/// ) 
/// $ 
/// &/* 

/// $ * Encoded in the loh_body field of data type layouthint4: 

/// & */ 

/// $ 

/// struct nfsv4 1 file layouthint4 ( 

111 uint32 t nflh care; 

111 nfl util4 nflh util; 

/// count 4 nflh_stripe_count; 

HE Ei 

LET 

/// & 

/// 

/// $ 

/// typedef netaddr4 multipath_list4<>; 

/// $ 

/// SIK 

/// $ * Encoded in the da addr body field of data type device addr4: 
/// & */ 

/// struct nfsv4 1 file layout ds addr4 { 

/// uint32_t nflda_stripe_indices<>; 

FEI multipath_list4 nflda_multipath_ds_list<>; 

VELIA SG 

111 
111 
111 


oe 
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111 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 


Haynes 


* 
$ * Encoded in the loc body field of data type layout content4: 
*/ 

struct nfsv4 1 file layout4 ( 


deviceid4 nfl deviceid; 
nfl util4 nfl util; 
uint32 t nfl first stripe index; 
offset4 nfl pattern offset; 
nfs fh4 nfl fh list<>; 
Yi 
/* 
* Operation arrays (the opnum first) 
A. 
enum nfs opnum4 ( 
OP ACCESS = 3, 
OP CLOSE = 4, 
OP COMMIT =: 5, 
OP CREATE = 6, 
OP DELEGPURGE = 7, 
OP DELEGRETURN = 8, 
OP GETATTR = 9, 
OP GETFH = 10, 
OP. LINK = 11, 
OP LOCK = 12, 
OP LOCKT = 13; 
OP LOCKU = 14, 
OP LOOKUP = 15, 
OP LOOKUPP = 16, 
OP NVERIFY = 17, 
OP OPEN =-18; 
OP OPENATTR = 19, 
OP OPEN CONFIRM = 20, /* Mandatory not-to-implement */ 
OP OPEN DOWNGRADE = 21, 
OP PUTFH = 22, 
OP PUTPUBFH = 23, 
OP PUTROOTFH = 24, 
OP READ 3°25; 
OP_READDIR = 26, 
OP_READLINK = 27, 
OP_REMOVE = 28, 
OP_RENAME = 29, 
OP_RENEW = 30, /* Mandatory not-to-implement */ 
Standards Track [Page 30] 


RFC 7863 


/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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/// 
/// 
/// 
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/// 
/// 
/// 
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oe oe 


oe 


oe 


OP. RESTOREFH = 31, 

OP SAVEFH = 32, 

OP. SECINFO = 33, 

OP. SETATTR = 34, 

OP SETCLIENTID 

OP SETCLIENTID CONFIRM = 36, /* Mandatory 
OP. VERIFY = 37, 

OP. WRITE = 38, 


OP. RELEASE LOCKOWNER 


NFSv4.2 XDR 


November 2016 


= 35, /* Mandatory not-to-implement */ 


not-to-implement */ 


= 39, /* Mandatory not-to-implement */ 


/* New operations for NFSv4.1 */ 


OP BACKCHANNEL CTL 


= 40, 


OP BIND CONN TO SESSION - 41, 


OP EXCHANGE ID 
OP CREATE SESSION 
OP DESTROY SESSION 
OP FREE STATEID 


OP GET DIR DELEGATION 


OP GETDEVICEINFO 
OP. GETDEVICELIST 
OP. LAYOUTCOMMIT 

OP. LAYOUTGET 

OP. LAYOUTRETURN 

OP SECINFO NO NAME 
OP. SEQUENCE 

OP SET SSV 

OP TEST STATEID 

OP WANT DELEGATION 
OP DESTROY CLIENTID 
OP RECLAIM COMPLETE 


- 42, 
- 43, 
- 44, 
= 45, 
- 46, 
- 47, 
- 48, 
- 49, 
- 50, 
= 51, 
- 52, 
- 58, 
= 54, 
= 55, 
= 56, 
= 57, 
= 58, 
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/// 
/// 
/// 
/// 
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/// 
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/// 
/// 
/// 
/// 
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oe 


oe 


OP. ALLOCATE 

OP. COPY 

OP COPY NOTIFY 

OP DEALLOCATE 

OP. IO ADVISE 

OP. LAYOUTERROR 

OP LAYOUTSTATS 

OP OFFLOAD CANCEL 
OP OFFLOAD STATUS 
OP READ PLUS 

OP. SEEK 

OP WRITE SAME 

OP. CLONE 

OP. ILLEGAL 


}; 


const 
const 
const 
const 
const 
const 


ACCESS4 READ 
ACCESS4 LOOKUP 
ACCESS4 MODIFY 
ACCESS4 EXTEND 
ACCESSA DELETE 
ACCESS4 EXECUTE 


struct ACCESS4args { 


}; 


/* CURRENT FH: 


uint32 t 


struct ACCESS4resok { 


}; 


union ACCESS4res switch 


case 


uint32 t 
uint32 t 


NFSA OK: 
ACCESS4resok 


default: 


}; 


void; 


NFSv4.2 XDR 


/* New operations for NFSv4.2 */ 


= 59, 
= 60, 
= 61, 
= 62, 
= 63, 
= 64, 
= 65, 
= 66, 
= 67, 
= 68, 
= 69, 
= 70, 
= 71, 
= 10044 


= 0x00000001; 
= 0x00000002; 
= 0x00000004; 
0x00000008; 
0x00000010; 
= 0x00000020; 


object */ 
access; 


supported; 


access; 


resok4; 
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/// struct CLONE4args { 


/// /* SAVED FH: source file */ 

111 /* CURRENT. FH: destination file */ 
111 stateid4 cl src stateid; 
111 stateid4 cl dst stateid; 
111 offset4 cl src offset; 
111 offset4 cl dst offset; 
111 length4 cl count; 

[Ll Y 

/// 

/// struct CLONE4res { 

/// nfsstat4 cl status; 

LED Ki 

/// struct CLOSE4args { 

/// /* CURRENI FH: object */ 

/// seqid4 seqid; 

/// stateid4 open_stateid; 
/// Yi 

/// 


/// union CLOSE4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// stateid4 open stateid; 
/// default: 

/// void; 

AU 

111 

/// struct COMMIT4args { 

/// /* CURRENT_FH: file */ 

/// offset4 offset; 
/// count4 count; 

AT. E; 

111 

/// struct COMMIT4resok { 

MM verifier4 writeverf; 
VE 

LEE 


/// union COMMIT4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// COMMIT 4resok resok4; 
/// default: 

/// void; 

//L Yi 

111 
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/// union createtype4 switch (nfs_ftype4 type) { 
/// case NF4LNK: 

FEL linktext4 linkdata; 

/// case NF4BLK: 

/// case NF4CHR: 

/// specdata4 devdata; 

/// case NF4SOCK: 

/// case NF4FIFO: 

/// case NF4DIR: 


/// void; 

/// default: 

/// void; /* Server should return NFS4ERR_BADTYPE. */ 
/// Yi 

/// 

/// struct CREATE4args { 

/// /* CURRENT_FH: directory for creation */ 

/// createtype4 objtype; 

/// component4 objname; 

111 fattr4 createattrs; 

JALA 

111 

/// struct CREATE4resok { 

/// change_info4 cinfo; 

/// bitmap4 attrset; /* Attributes set */ 
/// Yi 

/// 


/// union CREATE4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// /* New CURRENTFH: created object */ 
111 CREATE4resok resok4; 

/// default: 

/// void; 

/// Yi 

/// 

/// struct DELEGPURGE4args { 

FFF clientid4 clientid; 

/// Yi 

/// 

/// struct DELEGPURGE4res ( 

/// nfsstat4 status; 

/// Yi 

/// 

/// struct DELEGRETURN4args ( 

/// /* CURRENT_FH: delegated object */ 
/// stateid4 deleg_stateid; 

/// Yi 

/// 
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/// struct DELEGRETURN4res ( 


111 nfsstat4 status; 

LLI Yi 

111 

/// struct GETATTR4args { 

/// /* CURRENT_FH: object */ 

/// bitmap4 attr_request; 
/// Yi 

111 

/// struct GETATTR4resok { 

111 fattr4 obj attributes; 
/// Yi 

/// 


/// union GETATTR4res switch (nfsstat4 status) ( 
/// case NFS4_OK: 

/// GETATTR4resok resok4; 

/// default: 

/// void; 

/// Yi 

/// 

/// struct GETFH4resok { 

/// nfs_fh4 object; 

/// Yi 

/// 

/// union GETFH4res switch (nfsstat4 status) ( 
/// case NFS4_OK: 


/// GETFH4resok resok4; 

/// default: 

/// void; 

HAP M 

111 

/// struct LINK4args { 

/// /* SAVED FH: source object */ 
/// /* CURRENT_FH: target directory */ 
/// component4 newname; 

/// Yi 

/// 

/// struct LINK4resok ( 

/// change_info4 cinfo; 

/// Yi 

/// 


/// union LINK4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


111 LINK4resok resok4; 
/// default: 

111 void; 

AA 

111 
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/// /* 
/// * For LOCK, transition from open stateid and lock owner 
/// * toa lock stateid. 


/// */ 

/// struct open to lock owner4 ( 

111 segid4 open. segid; 
111 stateid4 open_stateid; 
/// seqid4 lock_seqid; 
/// lock_owner4 lock_owner; 
Viele ss 

/// 

LEE AZ 


/// * For LOCK, existing lock stateid continues to request new 
/// * file lock for the same lock owner and open stateid. 
VIT */ 


/// struct exist lock owner4 { 


111 stateid4 lock. stateid; 
11 segid4 lock. segid; 
LI y 

111 


/// union locker4 switch (bool new lock owner) ( 
/// case TRUE: 


/// open_to_lock_owner4 open_owner; 
/// case FALSE: 

/// exist lock owner4 lock owner; 
/// Yi 

/// 

/// /* 

/// * LOCK/LOCKT/LOCKU: Record lock management 
LIL */ 

/// struct LOCK4args { 

111 /* CURRENT FH: file */ 

111 nfs lock type4  locktype; 

AT bool reclaim; 

111 offset4 offset; 

FE length4 length; 

111 locker4 locker; 

/// Yi 

111 

/// struct LOCK4denied { 

FF offset4 offset; 

/// length4 length; 

/// nfs_lock_type4  locktype; 

/// lock_owner4 owner; 

/// Yi 

111 
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/// struct LOCK4resok { 

/// stateid4 lock_stateid; 

/// Yi 

/// 

/// union LOCK4res switch (nfsstat4 status) { 
/// case NFSA OK: 


/// LOCK4resok resok4; 
/// case NFS4ERR_DENIED: 

/// LOCK4denied denied; 
/// default: 

/// void; 

/// Yi 

/// 

/// struct LOCKT4args ( 

/// /* CURRENT. FH: file */ 
/// nfs lock type4  locktype; 
111 offset4 offset; 
111 length4 length; 
ETA lock owner4 owner; 
/// Yi 

111 


/// union LOCKT4res switch (nfsstat4 status) { 
/// case NFS4ERR_DENIED: 


/// LOCK4denied denied; 
/// case NFSA OK: 

/// void; 

/// default: 

/// void; 

/// Yi 

/// 

/// struct LOCKU4args { 

111 /* CURRENT FH: file */ 
111 nfs lock type4  locktype; 
/// seqid4 seqid; 
111 stateid4 lock stateid; 
111 offset4 offset; 
111 length4 length; 
/// Yi 

111 


/// union LOCKU4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// stateid4 lock. stateid; 
/// default: 

111 void; 

JL ane 

/// 
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/// struct LOOKUP4args { 


/// /* CURRENT_FH: directory */ 

/// component4 objname; 

/// Yi 

111 

/// struct LOOKUP4res ( 

/// /* New CURRENT_FH: object */ 
/// nfsstat4 status; 

/// Yi 

/// 

/// struct LOOKUPP4res { 

/// /* New CURRENT. FH: parent directory */ 
/// nfsstat4 status; 

/// Yi 

/// 

/// struct NVERIFY4args ( 

/// /* CURRENT_FH: object */ 

/// fattr4 obj_attributes; 
/// Yi 

/// 

/// struct NVERIFY4res ( 

/// nfsstat4 status; 

/// Yi 

/// 

PEL: AS 

/// * Various definitions for OPEN 

/// */ 

/// enum createmode4 { 

/// UNCHECKED4 = 0, 

111 GUARDED4 ec, 

111 /* Deprecated in NESv4.1 */ 

111 EXCLUSIVE4 = 2; 

111 /* 

11 * New to NFSv4.1. If session is persistent, 
/// * GUARDED4 MUST be used. Otherwise, use 
LES * EXCLUSIVE4_1 instead of EXCLUSIVE4. 
/// y 

/// EXCLUSIVE4 1 = 3 

/// Yi 

/// 

/// struct creatverfattr ( 

111 verifier4 cva_verf; 

/// fattr4 cva_attrs; 

/// Yi 

II 
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/// union createhow4 switch (createmode4 mode) { 
/// case UNCHECKED4: 
/// case GUARDED4: 


/// fattr4 createattrs; 
/// case EXCLUSIVE4: 

/// verifier4 createverf; 
/// case EXCLUSIVE4_1: 

/// creatverfattr ch createboth; 
SSL Vi 

111 

/// enum opentype4 { 

/// OPEN4 NOCREATE = 0, 

/// OPEN4_CREATE =1 

LET ES 

/// 


/// union openflag4 switch (opentype4 opentype) { 
/// case OPEN4_CREATE: 


/// createhow4 how; 
/// default: 

/// void; 

/// Yi 

/// 


/// /* Next definitions used for OPEN delegation */ 
/// enum limit_by4 { 


/// NES. LIMIT. SIZE zd 

/// NFS_LIMIT_BLOCKS - 2 

/// /* Others as needed */ 

EEL E 

/// 

/// struct nfs_modified_limit4 { 

111 uint32 t num blocks; 

111 uint32 t bytes per block; 
/// Yi 

111 


/// union nfs space limit4 switch (limit by4 limitby) { 
/// /* Limit specified as file size */ 

/// case NES LIMIT SIZE: 

111 uint64 t filesize; 

/// /* Limit specified by number of blocks */ 

/// case NFS LIMIT BLOCKS: 

FEL nfs_modified_limit4 mod_blocks; 

/// Yi 

/// 
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VALAS 
/// * Share Access and Deny constants for open argument 


111. */ 


/// const OPENA SHARE ACCESS READ = 0x00000001; 

/// const OPEN4 SHARE ACCESS WRITE = 0x00000002; 

/// const OPENA SHARE ACCESS BOTH = 0x00000003; 

11 

/// const OPENA SHARE DENY. NONE = 0x00000000; 

/// const OPEN4 SHARE DENY. READ = 0x00000001; 

/// const OPEN4 SHARE DENY. WRITE = 0x00000002; 

/// const OPEN4. SHARE DENY. BOTH = 0x00000003; 

111 

11 

/// /* New flags for share access field of CPAS sef 

/// const OPEN4 SHARE ACCESS WANT DELEG MASK = 0xFF00; 
/// const OPENA SHARE ACCESS WANT NO PREFERENCE = 0x0000; 
/// const OPEN4 SHARE ACCESS WANT READ DELEG = 0x0100; 
/// const OPEN4 SHARE ACCESS WANT WRITE DELEG = 0x0200; 
/// const OPENA SHARE ACCESS WANT ANY DELEG = 0x0300; 
/// const OPENA SHARE ACCESS WANT NO DELEG = 0x0400; 
/// const OPENA SHARE ACCESS WANT CANCEL = 0x0500; 
/// 

/// const 


/// OPEN4. SHARE ACCESS WANT SIGNAL DELEG WHEN RESRC AVAIL 
/// = 0x10000; 

/// 

/// const 

/// OPEN4_SHARE ACCESS WANT PUSH DELEG WHEN UNCONTENDED 
/// = 0x20000; 


/// 

/// enum open delegation type4 { 

/// OPEN DELEGATE NONE 0, 

111 OPEN DELEGATE READ = i 

111 OPEN. DELEGATE. WRITE 22; 

111 OPEN. DELEGATE. NONE. EXT 3 /* New to NFSv4.1 */ 
FFF KE 

111 
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/// enum open claim type4 { 


11 [e 

FEN * Not a reclaim 

111 */ 

11 CLAIM NULL zc, 

/// 

/// CLAIM PREVIOUS = 

111 CLAIM DELEGATE. CUR =; 

/// CLAIM DELEGATE PREV = 3, 

/// 

/// fx 

111 * Not a reclaim 

11 * 

/// * Like CLAIM NULL, but object identified 

111 * by the current filehandle 

11 */ 

11 CLAIM FH = 4, /* New to NFSv4.1 */ 
111 

111 JE 

111 * Like CLAIM DELEGATE. CUR, but object identified 
111 * by current filehandle 

11 ati 

/// CLAIM_DELEG_CUR_FH = 5, /* New to NFSv4.1 */ 
/// 

/// JE 

111 * Like CLAIM DELEGATE. PREV, but object identified 
111 * by current filehandle 

111 */ 

/// CLAIM_DELEG_PREV_FH = 6 /* New to NFSV4.1 */ 
/// Yi 

/// 

/// struct open_claim_delegate_cur4 { 

/// stateid4 delegate_stateid; 

/// component4 file; 

/// Yi 

/// 


/// union open claim4 switch (open claim type4 claim) ( 
FLE /* 

/// * No special rights to file. 

/// * Ordinary OPEN of the specified file. 


/// */ 

/// case CLAIM NULL: 

/// /* CURRENT_FH: directory */ 
/// component4 file; 
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LIA /* 
/// * Right to the file established by an 
/// * open previous to server reboot. File 


FL * identified by filehandle obtained at 
11 * that time rather than by name. 


11 A 

/// case CLAIM PREVIOUS: 

/// /* CURRENT_FH: file being reclaimed */ 
/// open delegation type4 delegate type; 
/// 

II] f* 


11 * Right to file based on a delegation 
111 * granted by the server. File is 
111 * specified by name. 


11 */ 

/// case CLAIM DELEGATE CUR: 

/// /* CURRENT_FH: directory */ 

/// open_claim_delegate_cur4 delegate_cur_info; 
/// 

II] f* 

/// * Right to file based on a delegation 

/// * granted to a previous boot instance 

/// * of the client. File is specified by name. 
/// */ 

/// case CLAIM DELEGATE PREV: 

/// /* CURRENT_FH: directory */ 

/// component4 file_delegate_prev; 
/// 

[EL {F 


/// * Like CLAIM_NULL. No special rights 
/// * to file. Ordinary OPEN of the 
/// * specified file by current filehandle. 


/// */ 

/// case CLAIM FH: /* New to NFSv4.1 */ 

/// /* CURRENT_FH: regular file to open */ 
/// void; 

/// 

AL EX 

/// * Like CLAIM_DELEGATE_PREV. Right to file based on a 
/// * delegation granted to a previous boot 

FL * instance of the client. File is identified 
111 * by filehandle. 

11 */ 

/// case CLAIM DELEG PREV FH: /* New to NFSv4.1 */ 
/// /* CURRENT_FH: file being opened */ 

/// void; 

/// 
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II] /* 

/// * Like CLAIM_DELEGATE_CUR. Right to file based on 
/// * a delegation granted by the server. 

/// * File is identified by filehandle. 

/// */ 

/// case CLAIM DELEG CUR FH: /* New to NFSv4.1 */ 

/// /* CURRENT_FH: file being opened */ 

/// stateid4 oc delegate stateid; 

111 

/// Yi 

/// 

FT AZ 

/// * OPEN: Open a file, potentially receiving an open delegation. 
{KI 7 

/// struct OPEN4args { 


/// seqid4 seqid; 

/// uint32_t share_access; 

/// uint32_t share_deny; 

/// open_owner4 owner; 

/// openflag4 openhow; 

111 open. claim4 claim; 

/// Yi 

/// 

/// struct open_read_delegation4 { 

/// stateid4 stateid; /* Stateid for delegation */ 
/// bool recall; /* Pre-recalled flag for 

/// delegations obtained 

/// by reclaim (CLAIM PREVIOUS) */ 
/// 

/// nfsace4 permissions; /* Defines users who don't 
/// need an ACCESS call to 

/// open for read */ 

/// Yi 

IL 

/// struct open write delegation4 ( 

/// stateid4 stateid; /* Stateid for delegation */ 
/// bool recall; /* Pre-recalled flag for 
/// delegations obtained 

/// by reclaim 

/// (CLAIM_PREVIOUS) */ 

/// 

/// nfs space limit4 

111 Space limit; /* Defines condition that 
/// the client must check to 
/// determine whether the 
/// file needs to be flushed 
/// to the server on close */ 
/// 


Haynes Standards Track [Page 43] 


RFC 7863 


/// 
/// 
/// 
/// 
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/// 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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nfsace4 


}; 
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permissions; /* Defines users who don't 
need an ACCESS call as 
part of a delegated 
open */ 


enum why_no_delegation4 { /* New to NFSv4.1 */ 


}; 


N 
N 


zz 


2 2 


2333535533535 
FA Z 


N 


D4_NOT_WANTED = 
D4 CONTENTION = 
D4 RESOURCE 
D4 NOT SUPP FTYPE = 
D4 WRITE DELEG NOT SUPP FTYPE = 
D4 NOT SUPP. UPGRADE = 
D4 NOT SUPP. DOWNGRADE = 
D4 CANCELLED = 
D4 IS DIR = 


` 


` 


© -I oO O1 & © 0I Oo 
s 


> 


` 


` 


` 


` 


union open_none_delegation4 /* New to NFSv4.1 */ 


switch 


}; 


(w 
c 


Cc 


d 


hy no delegation4 ond why) { 
ase WND4 CONTENTION: 

bool ond server will push deleg; 
ase WND4 RESOURCE: 

bool ond server will signal avail; 
efault: 

void; 


union open delegation4 


switch 


}; 
/* 


(o 
e 


Cc 


Cc 


Cc 


pen delegation type4 delegation type) ( 
ase OPEN DELEGATE NONE: 
void; 
ase OPEN DELEGATE READ: 
open read delegation4 read; 
ase OPEN DELEGATE WRITE: 
open write delegation4 write; 
ase OPEN DELEGATE NONE. EXT: /* New to NFSv4.1 */ 
open none delegation4 od whynone; 


* Result flags 


*/ 
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/// /* Client must confirm open. */ 

/// const OPEN4. RESULT. CONFIRM = 0x00000002; 

/// /* Type of file-locking behavior at the server */ 

/// const OPEN4 RESULT. LOCKTYPE POSIX = 0x00000004; 

/// /* Server will preserve file if removed while open. */ 
/// const OPENA RESULT PRESERVE UNLINKED - 0x00000008; 

11 

SSL up 

/// * Server may use CB NOTIFY LOCK on locks 

/// * derived from this open. 


111. */ 

/// const OPENA RESULT MAY NOTIFY. LOCK = 0x00000020; 

111 

/// struct OPEN4resok { 

/// stateid4 stateid; /* Stateid for open */ 

/// change info4 cinfo; /* Directory change info */ 
/// uint32 t rflags; /* Result flags */ 

/// bitmap4 attrset; /* Attribute set for create */ 
/// open delegation4 delegation; /* Info on any open 

111 delegation */ 

(1133 

111 


/// union OPEN4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// /* New CURRENT_FH: opened file */ 
111 OPEN4resok resok4; 

/// default: 

111 void; 

/// Yi 

111 

/// struct OPENATTR4args { 

/// /* CURRENT FH: object */ 

/// bool createdir; 

TIE Ag 

111 

/// struct OPENATTR4res { 

/// fx 

/// * If status is NFS4_OK, 

/// * New CURRENT_FH: named attribute 
/// id directory 

111 x 

111 nfsstat4 status; 

/// Yi 

111 
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/// /* Obsolete in NFSv4.1 */ 
/// struct OPEN_CONFIRM4args { 


/// /* CURRENT_FH: opened file */ 
/// stateid4 open_stateid; 
/// seqid4 seqid; 

/// Yi 

/// 

/// struct OPEN_CONFIRM4resok { 

/// stateid4 open_stateid; 
/// Yi 

/// 


/// union OPEN_CONFIRM4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// OPEN_CONFIRM4resok resok4; 
/// default: 

/// void; 

/// Yi 

/// 

/// struct OPEN DOWNGRADE4args { 

/// /* CURRENT_FH: opened file */ 
/// stateid4 open_stateid; 
/// seqid4 seqid; 

/// uint32_t share access; 
/// uint32_t share_deny; 
/// Yi 

/// 

/// struct OPEN_DOWNGRADE4resok { 

/// stateid4 open stateid; 
/// Yi 

/// 


/// union OPEN DOWNGRADE4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// OPEN_DOWNGRADE4resok resok4; 
/// default: 

/// void; 

/// Yi 

/// 

/// struct PUTFH4args { 

/// nfs_fh4 object; 

/// Yi 

/// 

/// struct PUTFH4res { 

/// /* 

111 * If status is NFS4_OK, 

/// * New CURRENT_FH: argument to PUTFH 
/// */ 

111 nfsstat4 status; 

/// Yi 
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111 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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struct PUTPUBFH4res { 
/* 


NFSv4.2 XDR 


* If status is NFS4 OK, 


# New CURRENT. FH: public fh 


* / 
nfsstat4 
}; 


struct PUTROOTFH4res ( 
/* 


status; 


* If status is NFS4 OK, 
x New CURRENT_FH: root fh 


x 
nfsstat4 
}; 


struct READ4args { 
/* CURRENT_FH: 
stateid4 
offset4 
count4 

}; 


struct READ4resok ( 
bool 
opague 

}; 


union READ4res switch 
case NFS4_OK: 
READ4resok 
default: 
void; 


}; 


struct READDIR4args { 


status; 


file */ 
stateid; 
offset; 
count; 


eof; 
data<>; 


(nfsstat4 status) 


resok4; 


/* CURRENT_FH: directory */ 


nfs_cookie4 
verifier4 
count4 
count4 
bitmap4 

}; 


cookie; 
cookieverf; 
dircount; 
maxcount; 
attr request; 
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/// struct entry4 { 


/// nfs_cookie4 cookie; 

/// component4 name; 

/// fattr4 attrs; 

/// entry4 *nextentry; 
/// Yi 

/// 

/// struct dirlist4 { 

/// entry4 *entries; 
/// bool eof; 

FED Y 

111 

/// struct READDIR4resok { 

FFF verifier4 cookieverf; 
/// dirlist4 reply; 
SAT 

111 

111 


/// union READDIR4res switch (nfsstat4 status) ( 
/// case NFSA OK: 

111 READDIR4resok resok4; 

/// default: 

/// void; 

/// Yi 

/// 

/// 

/// struct READLINK4resok ( 

111 linktext4 link; 

//L Yi 

/// 

/// union READLINK4res switch (nfsstat4 status) ( 
/// case NFS4_OK: 


/// READLINK4resok resok4; 
/// default: 

/// void; 

/// Yi 

/// 

/// struct REMOVE4args { 

/// /* CURRENT_FH: directory */ 
/// component4 target; 
LEE 

11 

/// struct REMOVE4resok { 

/// change, info4 cinfo; 
/// Yi 

/// 
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/// union REMOVE4res switch (nfsstat4 status) 


/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 


Haynes 


case NFSA OK: 

REMOVE4resok resok4; 
default: 

void; 


}; 


struct RENAME4args { 


/* SAVED_FH: source directory */ 


component4 oldname; 
/* CURRENT_FH: target directory */ 
component4 newname; 


}; 


struct RENAME4resok { 


change_info4 source_cinfo; 
change_info4 target_cinfo; 
}; 


union RENAME4res switch (nfsstat4 status) 


case NFS4_OK: 

RENAME4resok resok4; 
default: 

void; 


}; 


/* Obsolete in NESv4.1 */ 
struct RENEW4args { 


clientid4 clientid; 
}; 


struct RENEW4res ( 


nfsstat4 status; 
}; 


struct RESTOREFH4res ( 


/* 
* If status is NFS4 OK, 


x New CURRENT_FH: value of saved fh 


#7 
nfsstat4 status; 
}; 
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/// struct SAVEFH4res { 


/// yx 

FEN * If status is NFS4 OK, 

FL * New SAVED FH: value of current fh 
111 xf 

/// nfsstat4 status; 

/// Yi 

LIE 

/// struct SECINFO4args { 

/// /* CURRENT_FH: directory */ 
/// component4 name; 

/// Yi 

/// 

JUL AR 

/// * From RFC 2203 

/// */ 

/// enum rpc gss svo t { 

111 RPC. GSS. SVC. NONE =. 
111 RPC. GSS. SVC. INTEGRITY = 2; 
111 RPC GSS SVC PRIVACY = 3 
/// Yi 

/// 

/// struct rpcsec_gss_info { 

/// sec_oid4 oid; 

/// gop4 qop; 

111 rpc gss svc t service; 

/// Yi 

111 

/// /* RPCSEC GSS has a value of "6". See RFC 2203. */ 


/// union secinfo4 switch (uint32 t flavor) ( 
/// case RPCSEC GSS: 

111 rpcsec gss info flavor info; 
/// default: 

111 void; 

LE; 

FFF 

/// typedef secinfo4 SECINFO4resok<>; 

111 

/// union SECINFO4res switch (nfsstat4 status) ( 
/// case NFSA OK: 


/// /* CURRENTFH: consumed */ 
/// SECINFO4resok resok4; 

/// default: 

/// void; 

/// Yi 

/// 
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/// struct SETATTR4args { 


/// /* CURRENT FH: target object */ 
FEN stateid4 stateid; 

/// fattr4 obj_attributes; 
/// Yi 

111 

/// struct SETATTR4res { 

/// nfsstat4 status; 

/// bitmap4 attrsset; 

/// Yi 

/// 


/// /* Obsolete in NFSv4.1 */ 
/// struct SETCLIENTID4args ( 


FFF nfs client id4 client; 

111 cb client4 callback; 

111 uint32 t callback. ident; 

/// Yi 

/// 

/// struct SETCLIENTID4resok { 

/// clientid4 clientid; 

111 verifier4 setclientid confirm; 
/// Yi 

/// 


/// union SETCLIENTID4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// SETCLIENTID4resok resok4; 
/// case NFS4ERR CLID INUSE: 

/// clientaddr4 client_using; 
/// default: 

/// void; 

/// Yi 

111 


/// /* Obsolete in NFSv4.1 */ 
/// struct SETCLIENTID CONFIRM4args { 


111 clientid4 clientid; 

FFF verifier4 setclientid confirm; 
/// Yi 

/// 

/// struct SETCLIENTID CONFIRM4res ( 

111 nfsstat4 status; 

/// Yi 

111 

/// struct VERIFY4args { 

/// /* CURRENT_FH: object */ 

/// fattr4 obj_attributes; 
/// Yi 

/// 
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/// struct VERIFY4res { 
/// nfsstat4 status; 
/// Yi 
FL 
/// struct WRITE4args { 
111 /* CURRENT FH: file */ 
111 stateid4 stateid; 
111 offset4 offset; 
111 stable how4 stable; 
111 opague data<>; 
/// Yi 
/// 
/// struct WRITE4resok ( 
FFF count4 count; 
111 stable how4 committed; 
111 verifier4 writeverf; 
/// Yi 
111 
/// union WRITE4res switch (nfsstat4 status) 
/// case NFSA OK: 
111 WRITE4resok resok4; 
/// default: 
111 void; 
/// Yi 
/// 
/// /* Obsolete in NFSv4.1 */ 
/// struct RELEASE LOCKOWNER4args { 
111 lock. owner4 lock. owner; 
/// Yi 
/// 
/// struct RELEASE_LOCKOWNER4res { 
/// nfsstat4 status; 
/// Yi 
EPI 
/// struct ILLEGAL4res { 
/// nfsstat4 status; 
/// Yi 
/// 
/// typedef opague gsshandle4_t<>; 
/// 
/// struct gss cb handles4 ( 
111 rpc_gss_svc_t gcbp_service; /* RFC 2203 */ 
/// gsshandle4_t gcbp_handle_from_server; 
/// gsshandle4_t gcbp_handle_from_client; 
EY 
111 
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/// union callback sec parms4 switch (uint32 t cb secflavor) ( 
/// case AUTH NONE: 


111 void; 

/// case AUTH_SYS: 

/// authsys_parms cbsp sys cred; /* RFC 5531 */ 
/// case RPCSEC_GSS: 

/// gss cb handles4 cbsp gss handles; 
41439; 

111 

/// struct BACKCHANNEL CTL4args ( 

111 uint32 t bca, cb program; 
111 callback. sec parms4 bca sec parms<>; 
/// Yi 

/// 

/// struct BACKCHANNEL CTL4res { 

/// nfsstat4 bcr status; 
/// Yi 

111 

/// enum channel dir from client4 ( 

/// CDFC4. FORE = Oxl, 

/// CDFC4. BACK = 0x2, 

/// CDFC4 FORE OR BOTH = 0x3, 

/// CDFC4 BACK OR BOTH = 0x7 

FEFOXE 

WE 

/// struct BIND. CONN TO SESSION4args ( 

/// sessionid4 bctsa sessid; 

111 

/// channel dir from client4 

/// bctsa dir; 

/// 

/// bool bctsa use conn in rdma mode; 
/// Yi 

/// 

/// enum channel dir. from server4 { 

/// CDFS4_FORE = 0x1, 

/// CDFS4_BACK = 0x2, 

/// CDFS4 BOTH = 0x3 

FEL s 

/// 

/// struct BIND_CONN_TO_SESSION4resok { 

/// sessionid4 bctsr sessid; 

111 

/// channel dir from server4 

/// bctsr dir; 

/// 

/// bool bctsr use conn in rdma mode; 
JA pg 


Haynes Standards Track [Page 53] 


RFC 7863 NFSv4.2 XDR November 2016 


111 
/// union BIND. CONN TO SESSION4res 
/// switch (nfsstat4 bctsr status) { 


11 case NFS4 OK: 

/// BIND_CONN_TO_SESSION4resok bctsr_resok4; 
/// default: 

/// void; 

LA 

111 

/// const EXCHGIDA FLAG SUPP MOVED REFER - 0x00000001; 
/// const EXCHGID4 FLAG SUPP. MOVED MIGR - 0x00000002; 
/// const EXCHGIDA FLAG SUPP FENCE OPS - 0x00000004; 
111 

/// const EXCHGIDA FLAG BIND PRINC STATEID = 0x00000100; 
11 

/// const EXCHGID4 FLAG USE. NON. PNFS = 0x00010000; 
/// const EXCHGID4 FLAG USE. PNFS. MDS = 0x00020000; 
/// const EXCHGIDA FLAG USE PNFS DS = 0x00040000; 
/// 

/// const EXCHGID4 FLAG MASK PNFS = 0x00070000; 
/// 

/// const EXCHGIDA FLAG UPD CONFIRMED REC A = 0x40000000; 
/// const EXCHGIDA FLAG CONFIRMED R = 0x80000000; 
11 

/// struct state protect ops4 { 

111 bitmap4 spo must. enforce; 

111 bitmap4 spo must. allow; 

/// Yi 

/// 

/// struct ssv_sp_parms4 { 

/// state_protect_ops4 ssp_ops; 

/// sec_oid4 ssp_hash_algs<>; 

/// sec_oid4 ssp_encr_algs<>; 

/// uint32_t ssp_window; 

/// uint32_t ssp num gss handles; 
/// Yi 

11 

/// enum state protect. how4 { 

Li SP4 NONE - 0, 

/// SP4 MACH CRED - 1, 

111 SP4_SSV = 2 

/// Yi 

/// 
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111 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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union state_protect4_a switch 
case SP4_NONE: 


NFSv4.2 XDR 


(state protect how4 spa how) { 


Spa mach ops; 


Spa ssv parms; 


eia clientowner; 

eia flags; 

eia state protect; 

eia client impl id<1>; 


(state protect how4 spr how) { 


Spr mach ops; 


spr ssv info; 


eir server scope<NFS4 OPAQUE LIMIT»; 


void; 
case SP4 MACH CRED: 
state protect ops4 
case SPA SSV: 
SSV Sp parms4 
}; 
struct EXCHANGE ID4args { 
client. owner4 
uint32 t 
state protect4 a 
nfs impl id4 
}; 
struct ssv prot info4 { 
state protect ops4 Spi ops; 
uint32 t Spi hash alg; 
uint32 t Spi encr alg; 
uint32 t Spi ssv len; 
uint32 t spi window; 
gsshandle4 t spi handles<>; 
Yi 
union state protect4 r switch 
case SP4 NONE: 
void; 
case SP4 MACH CRED: 
state protect ops4 
case SP4 SSV: 
ssv prot info4 
}; 
struct EXCHANGE. ID4resok { 
clientid4 eir clientid; 
seguenceid4 eir_sequenceid; 
uint32_t eir_flags; 
state_protect4_r eir state protect; 
server. owner4 eir server owner; 
opaque 
nfs impl id4 eir server impl id<1>; 
}; 
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/// union EXCHANGE ID4res switch (nfsstat4 eir status) { 
/// case NFSA OK: 


/// EXCHANGE ID4resok eir resok4; 

/// 

/// default: 

/// void; 

/// Yi 

LIE 

/// struct channel_attrs4 { 

/// count4 ca_headerpadsize; 
/// count4 ca_maxreguestsize; 
/// count4 ca_maxresponsesize; 
/// count4 ca maxresponsesize cached; 
111 count4 ca. maxoperations; 
111 count4 ca maxrequests; 

111 uint32 t ca rdma ird<1>; 

/// Yi 

/// 

/// const CREATE SESSIONA FLAG PERSIST = 0x00000001; 
/// const CREATE_SESSION4_FLAG_CONN_BACK_CHAN = 0x00000002; 
/// const CREATE SESSION4. FLAG CONN RDMA = 0x00000004; 
111 

/// struct CREATE SESSION4args { 

/// clientid4 csa_clientid; 

/// seguenceid4 csa_seguence; 

111 

/// uint32_t csa_flags; 

/// 

/// channel_attrs4 csa fore chan attrs; 
111 channel. attrs4 csa back chan attrs; 
111 

111 uint32 t csa cb program; 

/// callback_sec_parms4 csa_sec_parms<>; 

EI SG 

/// 

/// struct CREATE_SESSION4resok { 

/// sessionid4 csr_sessionid; 

/// sequenceid4 csr_sequence; 

/// 

/// uint32_t csr_flags; 

/// 

/// channel_attrs4 csr fore chan attrs; 
111 channel. attrs4 csr back chan attrs; 
/// Yi 

/// 
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/// union CREATE. SESSION4res switch (nfsstat4 csr status) ( 
/// case NFSA OK: 


/// CREATE. SESSION4resok csr_resok4; 
/// default: 

/// void; 

/// Yi 

/// 

/// struct DESTROY_SESSION4args { 

/// sessionid4 dsa_sessionid; 

ELE; 

/// 

/// struct DESTROY_SESSION4res { 

/// nfsstat4 dsr_status; 

EEL a 

/// 

/// struct FREE_STATEID4args { 

/// stateid4 fsa_stateid; 

/// Yi 

/// 

/// struct FREE_STATEID4res { 

/// nfsstat4 fsr_status; 

/// Yi 

/// 

/// 

/// typedef nfstime4 attr notice4; 

/// 

/// struct GET_DIR_DELEGATION4args { 

/// /* CURRENT_FH: delegated directory */ 
/// bool gdda, signal. deleg avail; 
/// bitmap4 gdda_notification_types; 
/// attr_notice4 gdda_child_attr_delay; 
/// attr_notice4 gdda_dir_attr_delay; 
/// bitmap4 gdda_child_attributes; 
111 bitmap4 gdda dir attributes; 
EEKi 

/// struct GET. DIR DELEGATION4resok ( 

111 verifier4 gddr_cookieverf; 

/// /* Stateid for get_dir_delegation */ 
/// stateid4 gddr_stateid; 

/// /* Which notifications can the server support? */ 
FL bitmap4 gddr notification; 

111 bitmap4 gddr. child attributes; 
111 bitmap4 gddr dir attributes; 
"PE Ei 

/// 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
LEN 
111 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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enum gddrnf4_status { 
GDD4_OK = 0, 
GDD4_UNAVAIL 


| 
p 


}; 


union GET. DIR DELEGATION4res non. fatal 
switch (gddrnf4 status gddrnf status) { 
case GDD4 OK: 
GET. DIR DELEGATION4resok gddrnf_resok4; 
case GDD4 UNAVAIL: 
bool gddrnf will signal deleg avail; 
}; 


union GET. DIR DELEGATION4res 
switch (nfsstat4 gddr status) ( 
case NFSA OK: 


2016 


GET DIR DELEGATION4res non fatal gddr res non fatal4; 


default: 
void; 


}; 


struct GETDEVICEINFO4args { 


deviceid4 gdia_device_id; 
layouttype4 gdia_layout_type; 
count4 gdia_maxcount; 
bitmap4 gdia_notify_types; 


}; 


struct GETDEVICEINFO4resok ( 
device addr4 gdir device addr; 
bitmap4 gdir notification; 
Yi 


union GETDEVICEINFO4res switch (nfsstat4 gdir status) ( 
case NFS4 OK: 


GETDEVICEINFO4resok gdir resok4; 
case NFS4ERR TOOSMALL: 
count4 gdir mincount; 
default: 
void; 
ki 
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/// struct GETDEVICELIST4args { 


/// /* CURRENT_FH: object belonging to the file system */ 
/// layouttype4 gdla layout, type; 

/// 

/// /* Number of device IDs to return */ 

/// count4 gdla_maxdevices; 

/// 

/// nfs_cookie4 gdla_cookie; 

/// verifier4 gdla_cookieverf; 

SEP; 

/// 

/// struct GETDEVICELIST4resok { 

/// nfs_cookie4 gdlr cookie; 

111 verifier4 gdlr_cookieverf; 

/// deviceid4 gdlr deviceid list<>; 
/// bool gdlr_eof; 

/// Yi 

/// 


/// union GETDEVICELIST4res switch (nfsstat4 gdlr_status) { 
/// case NFS4_OK: 


/// GETDEVICELIST4resok gdlr resok4; 
/// default: 

111 void; 

kll OS 

/// 


/// union newtime4 switch (bool nt_timechanged) { 
/// case TRUE: 


/// nfstime4 nt_time; 
/// case FALSE: 

/// void; 

[LLY 

/// 


/// union newoffset4 switch (bool no_newoffset) { 
/// case TRUE: 


/// offset4 no_offset; 
/// case FALSE: 

/// void; 

FFY 

111 
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/// struct LAYOUTCOMMIT4args { 


/// /* CURRENT_FH: file */ 

/// offset4 loca_offset; 

/// length4 loca_length; 

111 bool loca reclaim; 

111 stateid4 loca stateid; 

111 newoffset4 loca last. write offset; 
/// newtime4 loca_time_modify; 

111 layoutupdate4 loca_layoutupdate; 
Viele 


/// union newsize4 switch (bool ns_sizechanged) { 
/// case TRUE: 


/// length4 ns_size; 

/// case FALSE: 

/// void; 

/// Yi 

/// 

/// struct LAYOUTCOMMIT4resok ( 

/// newsize4 locr newsize; 
/// Yi 

111 


/// union LAYOUTCOMMIT4res switch (nfsstat4 locr status) { 
/// case NFS4_OK: 


/// LAYOUTCOMMIT4resok locr_resok4; 
/// default: 

/// void; 

/// Yi 

/// 

/// struct LAYOUTGET4args ( 

/// /* CURRENT_FH: file */ 

/// bool loga_signal_layout_avail; 
/// layouttype4 loga layout type; 
/// layoutiomode4 loga_iomode; 

/// offset4 loga_offset; 

/// length4 loga_length; 

LES length4 loga minlength; 
111 stateid4 loga_stateid; 
/// count4 loga. maxcount; 
/// Yi 

/// struct LAYOUTGET4resok { 

/// bool logr_return_on_close; 
/// stateid4 logr_stateid; 

/// layout4 logr. layout<>; 

/// Yi 

/// 
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/// union LAYOUTGET4res switch (nfsstat4 logr status) { 
/// case NFS4 OK: 


111 LAYOUTGET4resok logr. resok4; 

/// case NFS4ERR LAYOUTTRYLATER: 

111 bool logr. will. signal layout. avail; 
/// default: 

/// void; 

La pa 

111 

111 

/// struct LAYOUTRETURN4args { 

/// /* CURRENT_FH: file */ 

111 bool lora reclaim; 

111 layouttype4 lora layout type; 
111 layoutiomode4 lora, iomode; 

111 layoutreturn4 lora_layoutreturn; 
/// Yi 

/// 

/// 


/// union layoutreturn stateid switch (bool lrs present) { 
/// case TRUE: 


111 stateid4 lrs_stateid; 
/// case FALSE: 

/// void; 

AN E 

111 


/// union LAYOUTRETURN4res switch (nfsstat4 lorr status) ( 
/// case NFSA OK: 


111 layoutreturn_stateid lorr_stateid; 
/// default: 

/// void; 

/// Yi 

/// 

/// enum secinfo_style4 { 

/// SECINFO_STYLE4_CURRENT_FH ONU 
/// SECINFO_STYLE4_PARENT exl 
/// Yi 

11 


/// /* CURRENT FH: object or child directory */ 
/// typedef secinfo style4 SECINFO NO NAME4args; 
11 

/// /* CURRENTFH: consumed if status is NFS4_OK */ 
/// typedef SECINFO4res SECINFO NO NAME4res; 

/// 
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/// struct SEQUENCE4args { 


/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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}; 


const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 
const 


sessionid4 S 
sequenceid4 S 
slotid4 S 


slotid4 S 
bool S 


SEQ4 STATUS CB PAT 
SEQ4 STATUS CB GSS 
SEQ4 STATUS CB GSS 
SEO4 STATUS EXPIRE 
SEO4 STATUS EXPIRE 


NFSv4.2 XDR 


a_sessionid; 

a sequenceig; 

a slotid; 

a highest slotid; 
a cachethis; 


H DOWN 

CONTEXTS EXPIRING 

. CONTEXTS EXPIRED 

D ALL STATE REVOKED 
D SOME STATE REVOKED 


SEO4 STATUS ADMIN 


STATE REVOKED 


SEO4 STATUS RECALL 


ABLE STATE REVOKED 


SEO4 STATUS LEASE MOVED 
SEO4 STATUS RESTART RECLAIM NEEDED 


SEQ4 STATUS CB PAT 


H DOWN. SESSION 


SEO4 STATUS BACKCH 


ANNEL FAULT 


SEO4 STATUS DEVID CHANGED 
SEO4 STATUS DEVID DELETED 


struct SEOUENCE4resok { 


}; 


union SEOUENCE4res switch 


sessionid4 
seguenceid4 
slotid4 
slotid4 
slotid4 
uint32 t 


case NFS4 OK: 


SEOUENCE4resok 


default: 


}; 


void; 


sr sessionid; 

sr seguenceid; 

sr slotid; 

sr highest slotid; 


sr target highest slotid; 


sr status flags; 


Sr resok4; 


struct ssa digest input4 ( 
SEOUENCE4args sdi segargs; 


}; 


struct SET SSV4args { 


}; 


opaque 
opaque 


St 


ssa_ssv<>; 
ssa_digest<>; 
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0x00000001; 
0x00000002; 
0x00000004; 
0x00000008; 
0x00000010; 
0x00000020; 
0x00000040; 
0x00000080; 
0x00000100; 
0x00000200; 
0x00000400; 
0x00000800; 
0x00001000; 
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/// struct ssr digest input4 { 

/// SEOUENCE4res sdi_segres; 

ELE VE 

/// 

/// struct SET_SSV4resok { 

/// opaque ssr digest<>; 

/// Yi 

/// 

/// union SET_SSV4res switch (nfsstat4 ssr_status) { 
/// case NFS4 OK: 


/// SET_SSV4resok ssr_resok4; 
/// default: 

/// void; 

FFF Y 

/// 

/// struct TEST_STATEID4args { 

/// stateid4 ts_stateids<>; 
/// )i 

/// 

/// struct TEST_STATEID4resok { 

/// nfsstat4 tsr_status_codes<>; 
/// Yi 

111 


/// union TEST. STATEID4res switch (nfsstat4 tsr status) ( 
/// case NFS4 OK: 


111 TEST. STATEID4resok tsr_resok4; 
/// default: 

111 void; 

/// Yi 

111 


/// union deleg claim4 switch (open claim type4 dc claim) ( 
/// /* 

/// * No special rights to object. Ordinary delegation 
/// * reguest of the specified object. Object identified 
/// * by filehandle. 


/// E 

/// case CLAIM FH: /* New to NFSv4.1 */ 

/// /* CURRENT. FH: object being delegated */ 
/// void; 

/// 

/// /* 


/// * Right to file based on a delegation granted 
/// * to a previous boot instance of the client. 
/// * File is specified by filehandle. 


///  */ 

/// case CLAIM DELEG PREV FH: /* New to NFSv4.1 */ 
111 /* CURRENT. FH: object being delegated */ 
111 void; 
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/// 

FET FE 

/// * Right to the file established by an open previous 
/// * to server reboot. File identified by filehandle. 
/// * Used during server reclaim grace period. 


LIE */ 

/// case CLAIM PREVIOUS: 

/// /* CURRENT FH: object being reclaimed */ 
/// open delegation type4 dc delegate type; 
/// Yi 

11 

/// struct WANT. DELEGATION4args { 

/// uint32_t wda_want; 

/// deleg_claim4 wda_claim; 

/// Yi 

/// 


/// union WANT_DELEGATION4res switch (nfsstat4 wdr status) { 
/// case NFS4_OK: 


[74 open delegation4 wdr resok4; 
/// default: 

111 void; 

/// Yi 

/// 

/// struct DESTROY_CLIENTID4args { 

/// clientid4 dca_clientid; 
ll Y 

111 

/// struct DESTROY_CLIENTID4res ( 

/// nfsstat4 dcr status; 
ETE Fa 

111 

/// struct RECLAIM COMPLETE4args { 

/// /* 

ETI * If rca one fs TRUE, 

111 m 

LES * CURRENT_FH: object in 
/// * file system for which the 
/// * reclaim is complete. 
/// #7 

111 bool rca one fs; 
TEE s 

/// 

/// struct RECLAIM COMPLETE4res { 

/// nfsstat4 rcr status; 
4148)? 

111 
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/// struct COPY4args { 


/// /* SAVED FH: source file */ 

111 /* CURRENT. FH: destination file */ 
111 stateid4 ca src stateid; 

111 stateid4 ca dst stateid; 

111 offset4 ca src offset; 

111 offset4 ca dst offset; 

111 length4 ca count; 

111 bool ca consecutive; 

111 bool ca, synchronous; 

111 netloc4 ca. source server<>; 
/// Yi 

111 

111 

/// struct copy requirements4 { 

111 bool cr consecutive; 

111 bool cr synchronous; 

/// Yi 

111 

/// struct COPY4resok { 

/// write_response4 cr_response; 
/// copy. reguirements4 cr_requirements; 
/// Yi 

111 


/// union COPY4res switch (nfsstat4 cr status) { 
/// case NFSA OK: 


111 COPY4resok cr resok4; 

/// case NFS4ERR OFFLOAD NO REOS: 

111 copy. reguirements4 cr_requirements; 
/// default: 

/// void; 

/// Yi 

/// 

/// struct COPY NOTIFY4args ( 

111 /* CURRENT. FH: source file */ 

111 stateid4 cna_src_stateid; 

111 netloc4 cna destination server; 
/// Yi 

/// 

/// struct COPY NOTIFY4resok ( 

(11 nfstime4 cnr lease time; 

111 stateid4 cnr_stateid; 

111 netloc4 cnr_source_server<>; 
/// Yi 

/// 
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/// union COPY NOTIFY4res switch (nfsstat4 cnr status) { 
/// case NFSA OK: 


111 COPY. NOTIFY4resok resok4; 
/// default: 

111 void; 

/// Yi 

/// 

/// struct OFFLOAD_CANCEL4args { 

/// /* CURRENT. FH: file to cancel */ 
/// stateid4 oca_stateid; 

FED Y 

111 

/// struct OFFLOAD_CANCEL4res { 

/// nfsstat4 ocr status; 

/// Yi 

111 

111 

/// struct OFFLOAD. STATUS4args { 

ETA /* CURRENT. FH: destination file */ 
111 stateid4 osa stateid; 

/// Yi 

/// 

/// struct OFFLOAD_STATUS4resok { 

/// length4 osr count; 

/// nfsstat4 osr complete<1>; 
LIT Y 

111 


/// union OFFLOAD. STATUS4res switch (nfsstat4 osr status) { 
/// case NFS4 OK: 


111 OFFLOAD. STATUS4resok osr resok4; 
/// default: 

111 void; 

/// Yi 

/// 

/// struct ALLOCATE4args { 

FFF /* CURRENT FH: file */ 

111 stateid4 aa stateid; 
111 offset4 aa offset; 
/// length4 aa_length; 
San 

/// struct ALLOCATE4res ( 

/// nfsstat4 ar status; 
/// Yi 

111 
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/// struct DEALLOCATE4args { 


/// /* CURRENT_FH: file */ 

/// stateid4 da_stateid; 

/// offset4 da_offset; 

/// length4 da length; 

/// Yi 

11 

11 

/// struct DEALLOCATE4res { 

/// nfsstat4 dr_status; 

/// Yi 

/// enum IO ADVISE type4 { 

/// IO ADVISE4 NORMAL - 0, 
111 IO ADVISE4. SEOUENTIAL e 
111 IO ADVISE4 SEQUENTIAL BACKWARDS = 2; 
/// IO ADVISE4 RANDOM = 3, 
11 IO ADVISE4 WILLNEED = 4, 
111 IO ADVISE4 WILLNEED OPPORTUNISTIC L5, 
/// IO ADVISE4 DONTNEED - 6, 
/// IO ADVISE4 NOREUSE = m 
/// IO_ADVISE4_READ = 8, 
/// IO ADVISE4 WRITE = 9, 
111 IO ADVISE4 INIT PROXIMITY = 10 
/// Yi 

/// 

/// struct IO ADVISE4args { 

/// /* CURRENT_FH: file */ 

/// stateid4 iaa stateid; 

111 offset4 iaa offset; 

111 length4 iaa count; 

111 bitmap4 iaa hints; 

/// Yi 

/// 

/// struct IO ADVISE4resok { 

/// bitmap4 ior hints; 

/// Yi 

11 


/// union IO ADVISE4res switch (nfsstat4 ior status) ( 
/// case NFSA OK: 

/// IO ADVISE4resok resok4; 

/// default: 

/// void; 

ALO 

111 

111 
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/// struct device error4 { 


/// deviceid4 de_deviceid; 

/// nfsstat4 de_status; 

/// nfs_opnum4 de_opnum; 

/// Yi 

/// 

/// 

/// struct LAYOUTERROR4args { 

/// /* CURRENT_FH: file */ 

/// offset4 lea_offset; 
/// length4 lea_length; 
/// stateid4 lea_stateid; 
/// device error4 lea_errors<>; 
SRI di 

/// 

/// struct LAYOUTERROR4res { 

/// nfsstat4 ler status; 

/// Yi 

/// 

/// struct io info4 { 

/// uint64_t ii count; 

/// uint64_t ii_bytes; 

/// Yi 

/// 

/// struct LAYOUTSTATS4args { 

111 /* CURRENT FH: file */ 

111 offset4 lsa offset; 
/// length4 lsa length; 
111 stateid4 lsa stateid; 
111 io info4 lsa read; 
111 io info4 lsa write; 
111 deviceid4 lsa_deviceid; 
/// layoutupdate4 lsa layoutupdate; 
EI SG 

111 

/// struct LAYOUTSTATS4res ( 

111 nfsstat4 lsr status; 

LEIS 

/// 

/// struct READ_PLUS4args { 

/// /* CURRENT FH: file */ 

111 stateid4 rpa_stateid; 

/// offset4 rpa_offset; 

/// count4 rpa_count; 

TIES 
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/// union read plus content switch (data content4 rpc content) ( 
/// case NFS4 CONTENT DATA: 


111 data4 rpc data; 

/// case NFS4 CONTENT. HOLE: 

/// data_info4 rpc_hole; 

/// default: 

/// void; 

/// Yi 

/// 

fT 

/// * Allow a retum of an array of contents. 
LL a 

/// struct read plus res4 ( 

/// bool rpr eof; 
/// read_plus_content rpr_contents<>; 
LAT; 

111 


/// union READ. PLUS4res switch (nfsstat4 rp status) { 
/// case NFS4_OK: 


/// read_plus_res4 rp_resok4; 
/// default: 

/// void; 

/// Yi 

/// 

/// struct SEEK4args { 

/// /* CURRENT FH: file */ 

111 stateid4 sa stateid; 
111 offset4 sa offset; 
111 data content4 sa what; 
Vide Di 

/// struct seek_res4 { 

/// bool sr_eof; 

/// offset4 sr_offset; 
EI Ys 


/// union SEEK4res switch (nfsstat4 sa status) { 
/// case NFSA OK: 


111 seek. res4 resok4; 
/// default: 

111 void; 

LATTES 

111 

/// struct WRITE SAME4args { 

111 /* CURRENT FH: file */ 

111 stateid4 wsa_stateid; 
/// stable_how4 wsa_stable; 
/// app_data_block4 wsa_adb; 
JUL» Ke 

111 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
LEN 
111 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 


Haynes 


union WRITE SAME4res switch 


case 


NFS4_OK: 


write_response4 


default: 


}; 


/* 


* Operation arrays 


void; 


nfs argop4 switch 
OP. ACCESS: 

OP. CLOSE: 

OP. COMMIT: 

OP CREATE: 

OP DELEGPURGE: 
OP DELEGRETURN: 
OP GETATTR: 

OP GETFH: 

OP LINK: 

OP. LOCK: 

OP LOCKT: 

OP. LOCKU: 

OP. LOOKUP: 

OP. LOOKUPP: 

OP NVERIFY: 

OP OPEN: 

OP OPENATTR: 


/* Not for NFSv4.1 */ 


case 


case 


case 
case 
case 
case 
case 
case 
case 
case 


OP OPEN CONFIRM: 


OP OPEN DOWNGRADE: 


OP PUTFH: 

OP PUTPUBFH: 
OP. PUTROOTFH: 
OP READ: 
OP. READDIR: 
OP. READLINK: 
OP. REMOVE: 
OP. RENAME: 
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(nfsstat4 wsr status) ( 


resok4; 


(the rest) 


(nfs_opnum4 argop) (< 
ACCESS4args opaccess; 
CLOSE4args opclose; 
COMMIT4args opcommit; 
CREATE4args opcreate; 
DELEGPURGE4args opdelegpurge; 
DELEGRETURN4args opdelegreturn; 
GETATTR4args opgetattr; 

void; 

LINK4args oplink; 

LOCK4args oplock; 

LOCKT4args oplockt; 
LOCKU4args oplocku; 
LOOKUP4args oplookup; 

void; 

NVERIFY4args opnverify; 
OPEN4args opopen; 
OPENATTR4args opopenattr; 


OPEN_CONFIRM4args opopen_confirm; 
OPEN_DOWNGRADE4args opopen_downgrade; 


PUTFH4args opputfh; 
void; 

void; 

READ4args opread; 
READDIR4args opreaddir; 
void; 

REMOVE4args opremove; 
RENAME 4args oprename; 
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/// /* Not for NFSv4.1 */ 


/// case OP. RENEW: RENEW4args oprenew; 

/// 

/// case OP_RESTOREFH: void; 

/// case OP_SAVEFH: void; 

/// case OP_SECINFO: SECINFO4args opsecinfo; 

/// case OP_SETATTR: SETATTR4args opsetattr; 

/// 

/// /* Not for NFSv4.1 */ 

/// case OP_SETCLIENTID: SETCLIENTID4args opsetclientid; 
/// 


/// /* Not for NFSv4.1 */ 
/// case OP. SETCLIENTID CONFIRM: 


LES SETCLIENTID_CONFIRM4args 

/// opsetclientid confirm; 
/// 

/// case OP_VERIFY: VERIFY4args opverify; 

/// case OP_WRITE: WRITE4args opwrite; 

/// 


/// /* Not for NFSv4.1 */ 
/// case OP RELEASE. LOCKOWNER: 


/// RELEASE_LOCKOWNER4args 
/// oprelease_lockowner; 
/// 


/// /* Operations new to NFSv4.1 */ 

/// case OP_BACKCHANNEL_CTL: 

/// BACKCHANNEL CTL4args opbackchannel ctl; 
111 
/// case OP. BIND. CONN TO SESSION: 

/// BIND_CONN_TO_SESSION4args 

/// opbind conn to session; 

111 

/// case OP EXCHANGE ID: EXCHANGE. ID4args opexchange id; 

111 

/// case OP CREATE SESSION: CREATE SESSION4args opcreate session; 
FE 

/// case OP DESTROY SESSION: 


/// DESTROY_SESSION4args opdestroy_session; 
11 

/// case OP FREE STATEID: FREE. STATEID4args opfree stateid; 

111 

/// case OP GET DIR DELEGATION: 

111 GET. DIR DELEGATION4args 

111 opget dir delegation; 

111 
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111 
111 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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case 
case 
case 
case 
case 


case 


case 
case 
case 


case 


case 


case 


OP_GETDEVICEINFO: 
OP_GETDEVICELIST: 
OP_LAYOUTCOMMIT: 
OP_LAYOUTGET: 
OP_LAYOUTRETURN: 


OP. SECINFO NO NAME: 


OP. SEQUENCE: 
OP. SET. SSV: 
OP. TEST. STATEID: 


OP. WANT. DELEGATION: 
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GETDEVICEINFO4args opgetdeviceinfo; 
GETDEVICELIST4args opgetdevicelist; 
LAYOUTCOMMIT4args oplayoutcommit; 
LAYOUTGET4args oplayoutget; 
LAYOUTRETURN4args oplayoutreturn; 


SECINFO NO NAME4args opsecinfo no name; 
SEOUENCE4args opsequence; 


SET SSV4args opset ssv; 
TEST STATEID4args optest stateid; 


WANT DELEGATION4args opwant delegation; 


OP DESTROY CLIENTID: 


DESTROY CLIENTID4args 
opdestroy clientid; 


OP RECLAIM COMPLETE: 


RECLAIM COMPLETE4args 
opreclaim complete; 


/* Operations new to NFSv4.2 */ 


case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 
case 


OP ALLOCATE: 
OP. COPY: 

OP COPY NOTIFY: 
OP. DEALLOCATE: 
OP. 10 ADVISE: 
OP. LAYOUTERROR: 
OP. LAYOUTSTATS: 


OP OFFLOAD CANCEL: 
OP OFFLOAD STATUS: 


OP READ PLUS: 
OP, SEEK: 
OP WRITE SAME: 
OP, CLONE: 
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ALLOCATE4args opallocate; 

COPY4args opcopy; 

COPY NOTIFY4args opoffload notify; 
DEALLOCATE4args opdeallocate; 

IO ADVISE4args opio advise; 
LAYOUTERROR4args oplayouterror; 
LAYOUTSTATS4args oplayoutstats; 
OFFLOAD CANCEL4args opoffload cancel; 
OFFLOAD STATUS4args opoffload status; 
READ PLUS4args opread plus; 

SEEK4args opseek; 

WRITE SAME4args opwrite same; 
CLONE4args opclone; 
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/// /* Operations not new to NFSv4.1 */ 


/// case OP ILLEGAL: void; 

LASE 

/// 

/// union nfs_resop4 switch (nfs_opnum4 resop) { 

/// case OP_ACCESS: ACCESS4res opaccess; 

/// case OP_CLOSE: CLOSE4res opclose; 

/// case OP_COMMIT: COMMIT4res opcommit; 

/// case OP CREATE: CREATE4res opcreate; 

/// case OP_DELEGPURGE: DELEGPURGE4res opdelegpurge; 
/// case OP_DELEGRETURN: DELEGRETURN4res opdelegreturn; 
/// case OP GETATTR: GETATTR4res opgetattr; 

/// case OP GETFH: GETFH4res opgetfh; 

/// case OP LINK: LINK4res oplink; 

/// case OP LOCK: LOCK4res oplock; 

/// case OP LOCKT: LOCKT4res oplockt; 

/// case OP LOCKU: LOCKU4res oplocku; 

/// case OP LOOKUP: LOOKUP4res oplookup; 

/// case OP LOOKUPP: LOOKUPP4res oplookupp; 

/// case OP NVERIFY: NVERIFY4res opnverify; 

/// case OP OPEN: OPEN4res opopen; 

/// case OP OPENATTR: OPENATTR4res opopenattr; 

/// /* Not for NFSv4.1 */ 

/// case OP OPEN CONFIRM: OPEN CONFIRM4res opopen confirm; 
EL 


/// case OP OPEN DOWNGRADE: OPEN DOWNGRADE4res opopen downgrade; 
/// 


/// case OP_PUTFH: PUTFH4res opputfh; 

/// case OP_PUTPUBFH: PUTPUBFH4res opputpubfh; 
/// case OP_PUTROOTFH: PUTROOTFH4res opputrootfh; 
/// case OP_READ: READ4res opread; 

/// case OP_READDIR: READDIR4res opreaddir; 

/// case OP_READLINK: READLINK4res opreadlink; 
/// case OP_REMOVE: REMOVE4res opremove; 

/// case OP_RENAME: RENAME4res oprename; 

/// /* Not for NFSv4.1 */ 

/// case OP_RENEW: RENEW4res oprenew; 

/// case OP_RESTOREFH: RESTOREFH4res oprestorefh; 
/// case OP_SAVEFH: SAVEFH4res opsavefh; 

/// case OP_SECINFO: SECINFO4res opsecinfo; 

/// case OP_SETATTR: SETATTR4res opsetattr; 

/// /* Not for NFSv4.1 */ 

/// case OP_SETCLIENTID: SETCLIENTID4res opsetclientid; 
/// 
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/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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/* Not for NFSv4.1 */ 


case 


case 
case 


OP_SETCLIENTID_CONFIRM: 
SETCLIENTID_CONFIRM4res 
opsetclientid_confirm; 
OP_VERIFY: VERIFY4res opverify; 
OP_WRITE: WRITE4res opwrite; 


/* Not for NFSv4.1 */ 


case 


OP RELEASE LOCKOWNER: 
RELEASE LOCKOWNER4res 
oprelease_lockowner; 


/* Operations new to NFSv4.1 */ 


case 


case 


case 


case 


case 


case 


case 


case 
case 
case 
case 
case 


case 


case 


case 


case 


case 


OP BACKCHANNEL CTL: 
BACKCHANNEL CTL4res opbackchannel ctl; 


OP BIND. CONN TO SESSION: 
BIND. CONN TO SESSION4res 
opbind conn to session; 


OP EXCHANGE ID: EXCHANGE ID4res opexchange id; 
OP CREATE SESSION: CREATE SESSION4res opcreate session; 


OP DESTROY SESSION: 
DESTROY SESSION4res opdestroy session; 


OP FREE STATEID: FREE STATEID4res opfree stateid; 
OP GET DIR DELEGATION: 
GET DIR DELEGATION4res 
opget dir delegation; 


OP GETDEVICEINFO: GETDEVICEINFO4res opgetdeviceinfo; 
OP GETDEVICELIST: GETDEVICELIST4res opgetdevicelist; 


OP LAYOUTCOMMIT: LAYOUTCOMMIT4res oplayoutcommit; 
OP. LAYOUTGET: LAYOUTGET4res oplayoutget; 

OP. LAYOUTRETURN: LAYOUTRETURN4res oplayoutreturn; 
OP. SECINFO NO NAME: 


SECINFO NO NAME4res opsecinfo no name; 


OP SEQUENCE: SEOUENCE4res opsequence; 

OP SET SSV: SET SSV4res opset ssv; 

OP TEST STATEID: TEST STATEID4res optest stateid; 
OP WANT DELEGATION: 


WANT DELEGATION4res opwant delegation; 


Standards Track [Page 74] 


RFC 7863 NFSv4.2 XDR November 2016 


111 

/// case OP DESTROY CLIENTID: 

11 DESTROY CLIENTID4res 

111 opdestroy. clientid; 
111 

/// case OP. RECLAIM COMPLETE : 

/// RECLAIM_COMPLETE4res 

/// opreclaim complete; 
/// 

/// /* Operations new to NFSv4.2 */ 

/// case OP_ALLOCATE: ALLOCATE4res opallocate; 

/// case OP_COPY: COPY4res opcopy; 

/// case OP_COPY_NOTIFY: COPY_NOTIFY4res opcopy_notify; 
/// case OP_DEALLOCATE: DEALLOCATE4res opdeallocate; 
/// case OP_IO_ADVISE: IO_ADVISE4res opio_advise; 

/// case OP_LAYOUTERROR: LAYOUTERROR4res oplayouterror; 
/// case OP LAYOUTSTATS: LAYOUTSTATS4res oplayoutstats; 


/// case OP OFFLOAD CANCEL: OFFLOAD CANCEL4res opoffload cancel; 
/// case OP OFFLOAD STATUS: OFFLOAD STATUS4res opoffload status; 


/// case OP READ PLUS: READ PLUS4res opread plus; 
/// case OP SEEK: SEEK4res opseek; 

/// case OP WRITE SAME: WRITE SAME4res opwrite same; 
/// case OP CLONE: CLONE4res opclone; 

11 

/// /* Operations not new to NFSv4.1 */ 

/// case OP ILLEGAL: ILLEGAL4res opillegal; 
/// Yi 

11 

/// struct COMPOUND4args { 

/// utf8str_cs tag; 

/// uint32_t minorversion; 

/// nfs_argop4 argarray<>; 

/// Yi 

/// 

/// struct COMPOUND4res { 

/// nfsstat4 status; 

/// utf8str cs tag; 

/// nfs_resop4 resarray<>; 

/// Yi 

/// 

/// 


Haynes Standards Track [Page 75] 


RFC 7863 NFSv4.2 XDR November 2016 


ALALE 

/// * Remote file service routines 

PEZE KT 

/// program NFS4_PROGRAM ( 

/// version NFS_V4 { 

111 void 

111 NFSPROC4 NULL (void) = 0; 
111 

111 COMPOUND4res 

111 NFSPROC4_COMPOUND (COMPOUND4args) = 1; 
/// 

/// } = 4; 

/// } = 100003; 

/// 

LEGS 

/// * NFS4 callback procedure definitions and program 
ATL E 

/// struct CB GETATTR4args ( 


ETA nfs fh4 fh; 

/// bitmap4 attr request; 
/// Yi 

111 

/// struct CB GETATTR4resok { 

/// fattr4 obj attributes; 
/// Yi 

11 


/// union CB GETATTR4res switch (nfsstat4 status) { 
/// case NFS4_OK: 


/// CB_GETATTR4resok resok4; 
/// default: 

/// void; 

/// Yi 

/// 

/// struct CB RECALL4args { 

111 stateid4 stateid; 
111 bool truncate; 
111 nfs. fh4 fh; 

FLL Yi 

/// 

/// struct CB RECALL4res ( 

/// nfsstat4 status; 
/// Yi 

/// 


Haynes Standards Track [Page 76] 


RFC 7863 NFSv4.2 XDR November 2016 


BEL SEE 

/// * CB ILLEGAL: Response for illegal operation numbers 
SLI) 

/// struct CB ILLEGAL4res { 


111 nfsstat4 status; 

/// Yi 

111 

/// /* 

/// * NFSv4.1 callback arguments and results 

111. */ 

111 

/// enum layoutrecall_type4 { 

/// LAYOUTRECALL4 FILE = LAYOUTA RET REC FILE, 
E LAYOUTRECALL4_FSID = LAYOUTA RET REC FSID, 
111 LAYOUTRECALL4 ALL = LAYOUTA RET REC ALL 
LA 

111 

/// struct layoutrecall file4 { 

/// nfs fh4 lor fh; 

111 offset4 lor. offset; 

/// length4 lor length; 

111 stateid4 lor. stateid; 

ALI 

111 


/// union layoutrecall4 switch (layoutrecall type4 lor recalltype) { 
/// case LAYOUTRECALL4 FILE: 


111 layoutrecall file4 lor layout; 

/// case LAYOUTRECALL4 FSID: 

111 fsid4 lor. fsid; 

/// case LAYOUTRECALL4 ALL: 

111 void; 

/// Yi 

/// 

/// struct CB_LAYOUTRECALL4args { 

/// layouttype4 clora_type; 
/// layoutiomode4 clora_iomode; 
/// bool clora_changed; 
/// layoutrecall4 clora_recall; 
FEE E 

/// struct CB LAYOUTRECALL4res { 

/// nfsstat4 clorr_status; 

/// Yi 

/// 
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BEL SPE 

/// * Directory notification types 

[EE EL 

/// enum notify type4 { 

/// NOTIFY4 CHANGE. CHILD. ATTRS = 0; 
111 NOTIFY4 CHANGE DIR ATTRS zu 
111 NOTIFY4 REMOVE ENTRY =D, 
/// NOTIFY4_ADD_ENTRY = 3, 
/// NOTIFY4 RENAME ENTRY = 4, 
/// NOTIFY4 CHANGE COOKIE VERIFIER = 5 
LEI XG 

/// 

/// /* Changed entry information */ 

/// struct notify_entry4 { 

/// component4 ne file; 

111 fattr4 ne attrs; 

/// Yi 

/// 

/// /* Previous entry information */ 

/// struct prev_entry4 { 

/// notify_entry4 pe_prev_entry; 

/// /* What READDIR returned for this entry */ 
/// nfs_cookie4 pe_prev_entry_cookie; 
FEE Yi 

/// 

/// struct notify_remove4 { 

/// notify_entry4 nrm old entry; 

/// nfs_cookie4 nrm_old_entry_cookie; 
/// Yi 

/// 

/// struct notify_add4 { 

/// /* 

/// * During a rename, contains 

/// * the object that was deleted. 

/// SA 

FEN notify remove4 nad old entry«l»; 
/// notify_entry4 nad_new_entry; 
/// /* What READDIR would have returned for this entry */ 
/// nfs_cookie4 nad_new_entry_cookie<1>; 
/// prev_entry4 nad prev. entry<1>; 
111 bool nad last. entry; 
LT VER 

/// 

/// struct notify_attr4 { 

/// notify_entry4 na_changed_entry; 

/// Yi 

/// 
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/// struct notify rename4 { 


/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
/// 
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}; 


struct 


}; 
/* 


notify remove4  nrn old entry; 
notify add4 nrn new entry; 


notify verifier4 { 
verifier4 nv. old cookieverf; 
verifier4 nv new cookieverf; 


* Objects of type notify <>4 and 
* notify device <>4 are encoded in this. 


*/ 


typedef opaque notifylist4<>; 


struct 


}; 


struct 


}; 
struct 
}; 


struct 


}; 
struct 


}; 


notify4 { 

/* Composed from notify_type4 or notify deviceid type4 
bitmap4 notify mask; 

notifylist4 notify vals; 


CB NOTIFY4args { 


stateid4 cna_stateid; 
nfs_fh4 cna_fh; 
notify4 cna_changes<>; 


CB NOTIFY4res { 
nfsstat4 cnr status; 


CB PUSH DELEG4args ( 
nfs fh4 cpda fh; 
open delegation4 cpda delegation; 


CB PUSH DELEG4res { 
nfsstat4 cpdr status; 


*/ 
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const RCA4 TYPE MASK RDATA DLG = 0; 
const RCA4 TYPE MASK WDATA DLG = 1; 
const RCA4 TYPE MASK DIR DLG = 2; 
const RCA4 TYPE MASK FILE. LAYOUT = 3; 
const RCA4 TYPE MASK BLK LAYOUT = 4; 
const RCA4 TYPE MASK OBJ LAYOUT MIN = 8; 
const RCA4 TYPE MASK OBJ LAYOUT MAX = 9; 
const RCA4 TYPE MASK OTHER LAYOUT. MIN = 1:2 
const RCA4 TYPE MASK OTHER LAYOUT. MAX = 15; 
struct CB RECALL ANY4args { 

uint32_t craa_objects_to_keep; 
bitmap4 craa_type_mask; 

}; 
struct CB RECALL ANY4res ( 

nfsstat4 crar. status; 
}; 
typedef CB RECALL ANY4args CB RECALLABLE OBJ AVAIL4args; 
struct CB RECALLABLE OBJ AVAIL4res { 

nfsstat4 croa status; 
}; 
struct CB RECALL SLOT4args ( 

slotid4 rsa target highest. slotid; 
}; 
struct CB RECALL SLOT4res { 

nfsstat4 rsr status; 
}; 
struct referring call4 { 

seguenceid4 rc seguenceid; 

slotid4 rc_slotid; 
}; 
struct referring call list4 { 

sessionid4 rcl_sessionid; 

referring_call4 rcl_referring_calls<>; 
}; 
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/// struct CB SEOUENCE4args ( 


111 sessionid4 csa sessionid; 

FEN sequenceid4 csa sequenceid; 

/// slotid4 csa_slotid; 

/// slotid4 csa_highest_slotid; 

/// bool csa_cachethis; 

/// referring_call_list4 csa_referring_call_lists<>; 
EAT 

111 

/// struct CB SEOUENCE4resok { 

/// sessionid4 csr_sessionid; 

/// sequenceid4 csr_sequenceid; 

/// slotid4 csr slotid; 

111 slotid4 csr highest. slotid; 

111 slotid4 csr target highest. slotid; 
LATTE 

111 


/// union CB SEOUENCE4res switch (nfsstat4 csr status) { 
/// case NFS4_OK: 


/// CB_SEQUENCE4resok csr_resok4; 
/// default: 

/// void; 

/// Yi 

/// 

/// struct CB WANTS CANCELLED4args { 

111 bool cwca contended wants cancelled; 
111 bool cwca resourced wants. cancelled; 
FL 

111 

/// struct CB WANTS CANCELLED4res { 

111 nfsstat4 cwcr status; 

/// Yi 

111 

/// struct CB NOTIFY LOCK4args { 

111 nfs_fh4 cnla_fh; 

FFF lock. owner4 cnla lock. owner; 

/// Yi 

/// 

/// struct CB_NOTIFY_LOCK4res { 

/// nfsstat4 cnlr status; 

TEE gs 

111 
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FT A 

/// * Device notification types 

SKI] 

/// enum notify_deviceid_type4 ( 

111 NOTIFY DEVICEID4 CHANGE = 1, 
11 NOTIFY. DEVICEID4. DELETE = 2 
/// Yi 

/// 


/// /* For NOTIFY4 DEVICEID4 DELETE */ 
/// struct notify deviceid delete4 { 


111 layouttype4 ndd_layouttype; 
111 deviceid4 ndd_deviceid; 
/// Yi 

/// 


/// /* For NOTIFYA DEVICEIDA CHANGE */ 
/// struct notify_deviceid change4 ( 


/// layouttype4 ndc_layouttype; 
/// deviceid4 ndc_deviceid; 
ETA bool ndc immediate; 
/// Yi 

111 

/// struct CB NOTIFY DEVICEID4args { 

/// notify4 cnda_changes<>; 

FER; 

LET 

/// struct CB_NOTIFY_DEVICEID4res { 

/// nfsstat4 cndr_status; 
FEY; 

111 


/// union offload_info4 switch (nfsstat4 coa status) { 
/// case NFS4_OK: 


/// write_response4 coa_resok4; 

/// default: 

/// length4 coa_bytes_copied; 
LEVE 

/// struct CB OFFLOAD4args ( 

111 nfs. fh4 coa. fh; 

111 stateid4 coa stateid; 

111 offload info4 coa offload info; 
AL Nes 

/// struct CB OFFLOAD4res { 

/// nfsstat4 cor_status; 

/// Yi 
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/* 


* Various definitions for CB COMPOUND 


A 


o 
+ 


NFSv4.2 XDR 


enum nfs cb opnum4 { 


November 2016 


OP CB GETATTR = 3, 
OP CB RECALL = 4, 
$/* Callback operations new to NFSv4.1 */ 
OP CB LAYOUTRECALL = 5, 
OP CB NOTIFY = 6, 
OP CB PUSH DELEG = 7, 
OP CB RECALL ANY = 8, 
OP CB RECALLABLE OBJ AVAIL = 9, 
OP CB RECALL SLOT = 10, 
OP CB SEOUENCE = 11, 
OP CB WANTS CANCELLED = 12, 
OP CB NOTIFY LOCK = 13, 
OP CB NOTIFY. DEVICEID = 14, 
$/* Callback operations new to NFSv4.2 */ 
OP CB OFFLOAD = 15, 
OP CB ILLEGAL = 10044 
Yi 
union nfs cb argop4 switch (nfs cb opnum4 argop) ( 
case OP CB GETATTR: 
CB GETATTR4args opcbgetattr; 
/* New NFSv4.1 operations */ 
case OP CB RECALL: 
CB RECALL4args opcbrecall; 
case OP CB LAYOUTRECALL: 
CB LAYOUTRECALL4args opcblayoutrecall; 
case OP CB NOTIFY: 
CB NOTIFY4args opcbnotify; 
case OP CB PUSH DELEG: 
CB PUSH DELEG4args opcbpush deleg; 
case OP CB RECALL ANY: 
CB RECALL ANY4args opcbrecall any; 
case OP CB RECALLABLE OBJ AVAIL: 
CB RECALLABLE OBJ AVAIL4args opcbrecallable obj avail; 
case OP CB RECALL SLOT: 
CB RECALL SLOT4args opcbrecall slot; 
case OP CB SEOUENCE: 
CB SEOUENCE4args opcbseguence; 
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/// case OP CB WANTS. CANCELLED: 


/// CB_WANTS_CANCELLED4args opcbwants. cancelled; 
/// case OP CB NOTIFY. LOCK: 

/// CB_NOTIFY_LOCK4args opcbnotify lock; 

/// case OP CB NOTIFY DEVICEID: 

/// CB NOTIFY DEVICEID4args opcbnotify deviceid; 
/// 


/// /* New NFSv4.2 operations */ 
/// case OP CB OFFLOAD: 


/// CB_OFFLOAD4args opcboffload; 

/// 

/// case OP_CB_ILLEGAL: void; 

/// Yi 

/// 

/// union nfs cb resop4 switch (nfs cb opnum4 resop) { 
/// case OP. CB GETATTR: CB GETATTR4res  opcbgetattr; 
/// case OP. CB RECALL: CB. RECALL4res opcbrecall; 
/// 


/// /* New NFSv4.1 operations */ 
/// case OP. CB LAYOUTRECALL: 


111 CB LAYOUTRECALL4res 

111 opcblayoutrecall; 
/// 

/// case OP CB NOTIFY: CB NOTIFY4res opcbnotify; 

111 

/// case OP CB PUSH DELEG: CB PUSH. DELEG4res 

111 opcbpush_deleg; 
/// 

/// case OP CB RECALL ANY: CB RECALL ANY4res 

/// opcbrecall_any; 
/// 

/// case OP CB RECALLABLE OBJ AVAIL: 

111 CB RECALLABLE OBJ AVAIL4res 

/// opcbrecallable obj avail; 
/// 

/// case OP CB RECALL SLOT: 

111 CB RECALL SLOT4res 

111 opcbrecall slot; 
/// 

/// case OP. CB SEQUENCE: CB SEQUENCE4res opcbseguence; 
111 

/// case OP. CB WANTS CANCELLED: 

111 CB WANTS CANCELLED4res 

111 opcbwants. cancelled; 

II 
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/// case OP CB NOTIFY. LOCK: 


11 CB NOTIFY LOCK4res 

11 opcbnotify. lock; 
111 

/// case OP CB NOTIFY DEVICEID: 

/// CB_NOTIFY_DEVICEID4res 

/// opcbnotify deviceid; 
111 

/// /* New NFSv4.2 operations */ 

/// case OP. CB OFFLOAD: CB OFFLOAD4res  opcboffload; 
11 

/// /* Not new operation */ 

/// case OP_CB_ILLEGAL: CB_ILLEGAL4res opcbillegal; 
/// Yi 

/// 

/// 

/// struct CB_COMPOUND4args { 

/// utf8str_cs tag; 

/// uint32_t minorversion; 

/// uint32_t callback_ident; 

/// nfs cb argop4 argarray<>; 

/// Yi 

/// 

/// struct CB_COMPOUND4res { 

/// nfsstat4 status; 

/// utf8str cs tag; 

/// nfs cb resop4 resarray<>; 

/// Yi 

111 

11 

11 

/// /* 


/// * Program number is in the transient range, since the client 
/// * will assign the exact transient program number and provide 
/// * that to the server via the CREATE SESSION or 

/// * BACKCHANNEL CTL operations. 


IIL E 

/// program NFS4_CALLBACK { 

111 version NES CB ( 

111 void 

111 CB NULL (void) = 0; 

111 CB COMPOUND4res 

111 CB COMPOUND (CB COMPOUND4args) = 1; 
111 } = 1; 


/// ) = 0x40000000; 


«CODE ENDS» 
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3. Security Considerations 


See the Security Considerations section of [RFC7862]. 


4. IANA Considerations 


See the IANA Considerations section of [RFC7862]. 
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